Compartilhar via


Visão geral dos instantâneos do graph (versão prévia)

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

Observação

Esse recurso está atualmente em versão prévia pública. A funcionalidade e a sintaxe estão sujeitas a alterações antes da Disponibilidade Geral.

Um instantâneo de grafo é uma entidade de banco de dados que representa uma instância materializada de um modelo de grafo em um momento específico. Embora um modelo de grafo defina a estrutura e as fontes de dados, um instantâneo é a implementação de grafo que pode ser consultada.

Visão geral

Instantâneos de grafo fornecem:

  • Vinculação de modelo: Conectado a um modelo de grafo específico
  • Materialização pontual: representa o estado do grafo no momento da criação
  • Persistência: armazenado no banco de dados até ser descartado explicitamente
  • Consulta direta: habilita consultas sem recompilar o grafo
  • Armazenamento de metadados: contém informações de tempo de criação e modelo

Vários instantâneos do mesmo modelo de grafo permitem a análise histórica e a comparação temporal dos dados do grafo.

Estrutura de instantâneo do graph

Cada instantâneo de grafo contém dois componentes primários:

Metadados

  • Nome: Identificador de instantâneo exclusivo
  • SnapshotTime: carimbo de data/hora de criação
  • Informações do modelo:
    • ModelName: Nome do modelo de grafo de origem
    • ModelVersion: Versão do modelo na criação de instantâneo
    • ModelCreationTime: carimbo de data/hora de criação do modelo de origem

Dados de gráficos

  • Nós: nós materializados das operações do AddNodes modelo
  • Bordas: Relações materializadas das operações do AddEdges modelo
  • Propriedades: propriedades de nó e borda conforme definido no modelo

Configuração de instantâneo de exemplo

{
  "Metadata": {
    "Name": "UserInteractionsSnapshot",
    "SnapshotTime": "2025-04-28T10:15:30Z"
  },
  "ModelInformation": {
    "ModelName": "SocialNetworkGraph",
    "ModelVersion": "v1.2",
    "ModelCreationTime": "2025-04-15T08:20:10Z"
  }
}

Comandos de gerenciamento

Use estes comandos para gerenciar instantâneos de grafo:

Comando Propósito
.make graph_snapshot Criar um instantâneo de um modelo de grafo existente
.drop graph_snapshot Remover um instantâneo do banco de dados
.show graph_snapshots Listar instantâneos disponíveis no banco de dados

Consultando instantâneos

Consultar instantâneos de grafo usando a graph() função:

Consultar o instantâneo mais recente

graph("SocialNetworkGraph") 
| graph-match (person)-[knows]->(friend)
  where person.age > 30
  project person.name, friend.name

Consultar um instantâneo específico

graph("SocialNetworkGraph", "UserInteractionsSnapshot") 
| graph-match (person)-[knows]->(friend)
  where person.age > 30
  project person.name, friend.name

Para obter correspondência avançada de padrões e passagens, consulte operadores do Graph.

Principais benefícios

Instantâneos de grafo fornecem:

  • Desempenho aprimorado: elimina a recompilação de grafo para cada consulta
  • Consistência de dados: garante que todas as consultas operem em um estado de grafo idêntico
  • Análise temporal: habilita a comparação histórica entre períodos de tempo
  • Otimização de recursos: reduz o consumo de CPU e memória para operações repetidas