Veja um diagrama de entidade no banco de dados KQL

No Real-Time Intelligence, você pode exibir a linhagem e a relação dos itens de banco de dados KQL. A exibição permite explorar visualmente as relações entre entidades de banco de dados e ajudá-lo a entender o fluxo de dados da origem para o destino, fornecendo uma representação de grafo clara. Usando o diagrama de entidade, você pode gerenciar seu banco de dados com eficiência e obter uma compreensão mais profunda de como essas entidades interagem. Essa representação visual de entidades simplifica o gerenciamento de banco de dados e ajuda você a otimizar suas estruturas de dados, facilitando o rastreamento de dependências e a executar ações rapidamente.

Para obter informações sobre a linhagem dos workspaces no Fabric, consulte Lineage.

Pré-requisitos

• Um espaço de trabalho com uma capacidade habilitada para o Microsoft Fabric
• Um banco de dados KQL com permissões de exibição

Para usuários que desejam ativar os detalhes de ingestão:

• Permissões de Administrador de Banco de Dados ou Monitor de Banco de Dados para exibir detalhes de ingestão no diagrama de entidade. Para obter mais informações, confira Controle de acesso baseado em função.

Abrir exibição de diagrama de entidade

Para acessar a exibição, navegue até o banco de dados KQL desejado e selecione o diagrama de entidade.

O que você vê em uma exibição de diagrama de entidade?

Ao abrir o modo de exibição de diagrama de entidade, você verá as dependências entre todos os itens no banco de dados KQL.

A exibição de diagrama de entidade exibe as seguintes informações:

• Tables
• Atualizar políticas
• Tabelas externas
• Atalhos
• Visões materializadas
• Functions
• Exportações contínuas
• Entidades cruzadas de bases de dados
• Fluxos de eventos

Você pode selecionar um item para exibir suas relações com outros itens no banco de dados. O diagrama de entidade realça todos os itens relacionados a esse item e diminui o restante.

Fontes de dados

As fontes de dados mostradas no diagrama incluem Eventstream, Armazenamento do Azure, Hubs de Eventos do Azure e Business Events. Agora você pode ver mais detalhes sobre uma fonte de dados, incluindo seu mapeamento, formato dos dados, status de conectividade e número de registros ingeridos. Se você não precisar mais de uma conexão, pode excluí-la diretamente do diagrama de entidades.

Filtrar a visualização do diagrama de entidades

Filtrar por tipo de entidade

Use o filtro suspenso Tipo de entidade para selecionar os tipos de entidade que você deseja exibir no diagrama. Você pode escolher entre tabelas, funções, atalhos de visualização materializada e fontes de dados. Esse filtro ajuda você a focar em tipos específicos de entidades, facilitando a análise de relacionamentos e dependências dentro do seu banco de dados KQL.

Filtrar pela faixa de tempo de ingestão

Use o filtro suspenso Ingestion para selecionar um intervalo de tempo para o qual deseja visualizar os detalhes da ingestão. Esse filtro adiciona as informações de ingestão ao cartão da entidade relevante no diagrama, para que você possa analisar o fluxo de dados e os padrões de ingestão ao longo do tempo.

Filtre por função específica ou tabela

Filtre a visualização do diagrama de entidades selecionando uma função ou tabela específica no painel de navegação à esquerda. Esse filtro ajuda você a focar em uma função ou tabela específica e suas entidades relacionadas, facilitando a análise de relações e dependências dentro do seu banco de dados KQL.

Violações de esquema

As violações de esquema ajudam a identificar inconsistências ou referências interrompidas entre entidades de banco de dados. Aqui estão alguns exemplos de violações de esquema:

• Uma função faz referência a uma tabela ou coluna que não existe mais.
• Uma função faz referência a outra função que não existe mais.
• Uma função faz referência a uma função com um número ou tipo incorreto de parâmetros.
• Uma função faz referência a uma coluna cujo tipo de dados foi alterado.
• Uma política de atualização faz referência a uma função ou tabela de origem que não existe mais.
• Uma política de atualização faz referência a uma função cujo esquema de saída não corresponde ao esquema da tabela de destino.
• Mapeamento de ingestão inválido (por exemplo, uma ou mais colunas definidas no mapeamento não existem na tabela de destino).
• Exportação contínua inválida (por exemplo, uma tabela ou coluna referenciada não pôde ser encontrada).
• Uma tabela externa não pode ser acessada porque o local de armazenamento pode não existir ou não há permissões suficientes para acessá-la.

Habilitar a exibição de Violações de Esquema realça entidades afetadas diretamente no diagrama. Clicar na instância de Violação de Esquema abre um painel lateral com detalhes sobre a violação.

Esse recurso permite que você localize e resolva rapidamente dependências interrompidas, garantindo que seu banco de dados eventhouse permaneça consistente e confiável.

Para quais cenários você pode usar diagramas de entidade?

Esta seção explora vários cenários em que você pode usar a exibição de diagrama de entidade no banco de dados KQL:

Gerenciar dependências proativamente

O gerenciamento de dependências entre entidades, como tabelas e funções, torna-se simples com a linhagem. Por exemplo, se você renomear uma tabela ou alterar seu esquema, poderá identificar instantaneamente quais funções dependem dessa tabela em sua consulta KQL. Essa abordagem proativa ajuda a evitar problemas inesperados e garante atualizações perfeitas para sua estrutura de banco de dados.

Rastrear relações entre exibições materializadas e tabelas de origem

Os diagramas de entidade permitem que você rastreie as relações entre exibições materializadas e suas tabelas de origem subjacentes. Isso simplifica a identificação de fontes de dados originais, permitindo que você acompanhe e solucione problemas de fluxo de dados com mais eficiência.

Interagir com elementos e agir

Você pode selecionar em qualquer elemento no grafo para realçar seus itens relacionados, enquanto o restante do grafo está esmaecido, facilitando o foco em relações específicas. Para tabelas e tabelas externas, nas reticências [...], você pode selecionar outras opções, como consultar a tabela, criar um relatório do Power BI com base na tabela e muito mais.

Monitoramento da ingestão de registros

Os diagramas de entidade permitem que você acompanhe quantos registros foram ingeridos em cada tabela e na exibição materializada. Essa visão clara dos fluxos de dados ajuda você a se manter informado sobre o tamanho e o volume de carregamento, garantindo que seu banco de dados processe os dados corretamente.

Conteúdo relacionado

• Linhagem do espaço de trabalho