Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
Observação
Esta funcionalidade está atualmente em pré-visualização pública. A funcionalidade e a sintaxe estão sujeitas a alterações antes da Disponibilidade Geral.
Os gráficos persistentes permitem armazenar, gerenciar e consultar estruturas de dados de gráficos em escala. Ao contrário dos gráficos transitórios criados com o operador make-graph , os gráficos persistentes são objetos de banco de dados duráveis que persistem além das execuções de consulta individuais, fornecendo recursos de análise de gráficos de nível empresarial.
Visão geral
Os gráficos persistentes consistem em dois componentes principais:
- Modelos de gráficos: defina a estrutura e o esquema do seu gráfico
- Instantâneos de gráfico: instâncias persistentes de modelos de gráfico que você pode consultar
Essa arquitetura oferece flexibilidade na definição de esquemas gráficos e eficiência na consulta de dados gráficos em escala.
Principais benefícios
Os gráficos persistentes oferecem vantagens significativas para a análise de gráficos em escala empresarial:
- Armazenamento durável: modelos gráficos e snapshots persistem nos metadados do banco de dados para disponibilidade a longo prazo
- Escalabilidade: lide com gráficos grandes que excedem as limitações de memória de nó único
- Reutilização: Vários usuários e aplicativos podem consultar a mesma estrutura gráfica sem reconstrução
- Otimização de desempenho: elimine a sobrecarga de construção de gráficos para consultas repetidas
- Suporte a esquemas: definições estruturadas para diferentes tipos de nó e borda com suas propriedades
- Controle de versão: vários instantâneos permitem a representação de gráficos em diferentes pontos no tempo
Modelos gráficos
Um modelo de gráfico define as especificações de um gráfico armazenado nos metadados do banco de dados. Inclui:
- Definição de esquema: tipos de nó e borda com suas propriedades
- Mapeamentos de fonte de dados: instruções para criar o gráfico a partir de dados tabulares
- Rótulos: rótulos estáticos (predefinidos) e dinâmicos (gerados em tempo de execução) para nós e bordas
Os modelos de gráfico contêm o plano para criar instantâneos de gráfico, não os dados reais do gráfico.
Gerenciando modelos gráficos
Os seguintes comandos estão disponíveis para gerenciar modelos de gráficos:
| Comando | Descrição |
|---|---|
| graph_model .create-or-alter | Cria um novo modelo de gráfico ou altera um modelo existente |
| .mostrar graph_model | Exibe detalhes de um modelo de gráfico específico |
| .mostrar graph_models | Lista todos os modelos de gráficos no banco de dados |
| .drop graph_model | Remove um modelo de gráfico |
Instantâneos gráficos
Um instantâneo gráfico é a instância real do gráfico materializada a partir de um modelo gráfico. Representa:
- Uma visão point-in-time específica dos dados, conforme definido pelo modelo
- Os nós, bordas e suas propriedades em um formato consultável
- Uma entidade independente que persiste até ser explicitamente removida
Os instantâneos são as entidades que você consulta ao trabalhar com gráficos persistentes.
Gerenciando instantâneos de gráficos
Os seguintes comandos estão disponíveis para gerenciar instantâneos de gráficos:
| Comando | Descrição |
|---|---|
| .make graph_snapshot | Cria um novo instantâneo de gráfico a partir de um modelo de gráfico |
| .mostrar graph_snapshot | Exibe detalhes de um instantâneo gráfico específico |
| .mostrar graph_snapshots | Lista todos os instantâneos de gráfico no banco de dados |
| .drop graph_snapshot | Remove um único instantâneo de gráfico |
| .drop graph_snapshots | Remove vários instantâneos gráficos com base em critérios |
Fluxo de trabalho
O fluxo de trabalho típico para criar e usar gráficos persistentes segue estas etapas:
- Criar um modelo de gráfico - Defina a estrutura e as fontes de dados para o seu gráfico
- Criar um instantâneo de gráfico - Materialize o modelo de gráfico em um instantâneo consultável
- Consultar o instantâneo do gráfico - Use operadores de gráfico KQL para analisar os dados do gráfico
- Gerenciar ciclo de vida - Crie novos instantâneos conforme necessário e elimine os antigos
Consultando gráficos persistentes
Uma vez que um instantâneo de gráfico é criado, ele pode ser consultado usando a graph função seguida por outros operadores de gráfico KQL:
graph("MyGraphModel")
| graph-match (n)-[e]->(m)
project n, e, m
Para consultar um snapshot específico, forneça o nome do snapshot:
graph("MyGraphModel", "MyGraphSnapshot")
| graph-match (n)-[e]->(m)
project n, e, m
O graph-match operador permite a correspondência de padrões e operações de travessia, enquanto graph-shortest-paths ajuda a encontrar conexões ideais entre entidades. O graph-to-table operador converte os resultados do gráfico de volta para o formato tabular.
Principais considerações
Esta seção descreve as principais considerações e limitações atuais de modelos de gráficos e instantâneos.
Limitações de snapshot
Os gráficos persistentes têm as seguintes limitações:
- Limite regular do banco de dados: máximo de 5.000 instantâneos gráficos por banco de dados
- Limite de cluster virtual gratuito: máximo de 500 instantâneos de gráfico por banco de dados
- Tempo de criação do snapshot: limitado a 1 hora