Veja um diagrama de entidades na base de dados KQL

No Real-Time Intelligence, você pode visualizar a linhagem e o relacionamento dos itens do 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 gráfica clara. Usando o diagrama de entidades, você pode gerenciar eficientemente seu banco de dados 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 tomada de ações rapidamente.

Para obter informações sobre a linhagem do espaço de trabalho no Fabric, consulte Linhagem.

Pré-requisitos

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 mais informações, consulte Controle de acesso baseado em funções.

Abrir vista de diagrama de entidade

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

Captura de ecrã a mostrar o botão de vista do diagrama de entidades.

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

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

A vista do diagrama de entidade exibe as seguintes informações:

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

Fontes de dados

As fontes de dados apresentadas no diagrama incluem Eventstream, Armazenamento do Azure, Hubs de Eventos do Azure e Business Events. Agora pode ver mais detalhes sobre uma fonte de dados, incluindo o seu mapeamento, formato dos dados, estado de conectividade e número de registos ingeridos. Se já não precisares de uma ligação, podes apagá-la diretamente do diagrama de entidades.

Captura de ecrã do diagrama da entidade a mostrar detalhes adicionais sobre uma fonte de dados.

Observação

Apenas Eventstreams, Event Hubs, Armazenamento do Azure Account e Fabric Business Events aparecem como fontes externas na vista do diagrama de entidades. O diagrama de entidades não mostra outras fontes externas.

Filtrar a vista do diagrama de entidades

Filtrar por tipo de entidade

Utilize o filtro de lista pendente Tipo de entidade para selecionar os tipos de entidades que pretende mostrar no diagrama. Pode escolher entre tabelas, funções, atalhos de visualização materializada e fontes de dados. Este filtro ajuda-o a focar-se em tipos específicos de entidades, facilitando a análise de relações e dependências dentro da sua base de dados KQL.

Captura de ecrã do diagrama de entidades com a lista pendente do filtro do tipo de entidade aberta.

Filtrar por intervalo de tempo de ingestão

Utilize o filtro pendente Ingestão para selecionar um intervalo de tempo para o qual pretende ver os detalhes de ingestão. Este filtro adiciona a informação de ingestão ao cartão da entidade relevante no diagrama, para que possas analisar os padrões de fluxo de dados e de ingestão ao longo do tempo.

Captura de ecrã do diagrama de entidades com a lista pendente do filtro de intervalo temporal de ingestão aberta.

Filtrar por função específica ou tabela

Filtre a vista do diagrama de entidades selecionando uma função ou tabela específica no painel de navegação esquerdo. Este filtro ajuda-o a focar-se numa função ou tabela específica e nas suas entidades relacionadas, facilitando a análise de relações e dependências dentro da sua base de dados KQL.

Captura de ecrã do diagrama de entidades com uma função ou tabela específica selecionada no painel de navegação à esquerda.

Violações de esquema

As violações de esquema ajudam a identificar inconsistências ou referências quebradas 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 de parâmetros incorretos.
  • 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, não foi possível encontrar uma tabela ou coluna referenciada).
  • 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.

Observação

Os atalhos são chamados de "tabelas externas" no recurso de violações de esquema.

A ativação da funcionalidade mostrar violações do esquema destaca as entidades afetadas diretamente no diagrama. Clicar na instância 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 quebradas, garantindo que seu banco de dados do Eventhouse permaneça consistente e confiável.

Captura de tela de um diagrama de entidade, mostrando violações de esquema realçadas em vermelho.

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

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

Gerencie dependências de forma proativa

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 a estrutura do banco de dados.

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

Os diagramas de entidade permitem rastrear 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 de forma mais eficaz.

Interaja com elementos e aja

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

Captura de tela de uma tabela de diagrama de entidade, mostrando o menu de mais opções.

Histórico de ingestão

Os diagramas de entidade permitem controlar quantos registros foram ingeridos em cada tabela e exibição materializada. Essa visão clara dos fluxos de dados ajuda você a acompanhar o tamanho e o volume da ingestão, garantindo que seu banco de dados processe os dados corretamente.