Exibir um diagrama de entidade no banco de dados KQL (visualização)

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

• Um espaço de trabalho com uma capacidade habilitada através de 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 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.

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:

• Tables
• Atualizar políticas
• Tabelas externas
• Visões materializadas
• Funções
• Exportações contínuas
• Entidades em múltiplos bancos 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 destaca todos os itens relacionados a esse item e escurece o restante.

Ver detalhes da ingestão

Você também pode visualizar os detalhes de ingestão de cada tabela e visualização materializada. Para ver os detalhes da ingestão, no lado direito do friso, selecione Ingestão e, em seguida, o intervalo de tempo pretendido. A informação é adicionada ao cartão da entidade relevante.

Visualizar detalhes da ingestão a partir do Eventstreams

Você também pode exibir detalhes de ingestão para cada tabela originada do Eventstream.

Além do nome do fluxo de eventos, você pode ver informações adicionais selecionando o ícone de fluxo verde, que revela o nome do fluxo derivado e o nome do mapeamento de ingestão. Se nenhum mapeamento for exibido, o mapeamento padrão (identidade) está sendo usado. Ao ativar Detalhes de ingestão em Mostrar detalhes, você verá o número de registros ingeridos em cada tabela de todas as fontes, incluindo fluxos de eventos.

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.

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.

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.

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.

Conteúdo relacionado

• Linhagem do espaço de trabalho