Exibir um diagrama de entidade no banco de dados KQL (versão prévia)

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
• Políticas de atualização
• Tabelas externas
• 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.

Exibir detalhes de ingestão

Você também pode visualizar os detalhes de ingestão de cada tabela e de cada visão materializada. Para exibir detalhes de ingestão, no lado direito da faixa de opções, selecione Ingestão e, em seguida, o intervalo de tempo desejado. As informações são adicionadas ao cartão da entidade relevante.

Exibir detalhes de ingestão do Eventstreams

Você também pode exibir detalhes de ingestão para cada tabela originária de 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 habilitar os detalhes de Ingestão em Mostrar detalhes, você verá o número de registros ingeridos em cada tabela de todas as fontes, incluindo Eventstreams.

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