função gráfica (pré-visualização)

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer

A graph função é uma função intrínseca que permite consultar uma entidade gráfica persistente, semelhante às cluster()funções , database(), external_table()e table() . Ele suporta a recuperação do instantâneo mais recente do gráfico, um instantâneo específico ou a criação de um gráfico transitório a partir do modelo.

Permissões

Para executar essa função, o usuário precisa de permissões do visualizador de banco de dados.

Sintaxe

graph( Nome do gráfico)

graph( Nome do gráfico,Nome do instantâneo)

graph( Nome do gráfico,snapshot=Nome do instantâneo)

graph( Nome do gráfico,Transitório)

Parâmetros

Devoluções

A graph função retorna um gráfico e deve ser seguida por um operador de gráfico. A função recupera o nome do modelo de gráfico especificado, como:

• O instantâneo mais recente (padrão ou quando false é especificado)
• Um instantâneo nomeado específico
• Um gráfico transitório do modelo (quando true especificado)

Exemplos

Consultar o snapshot mais recente

O exemplo a seguir consulta o instantâneo mais recente de um gráfico persistente chamado "SecurityGraph":

graph("SecurityGraph")
| graph-match (user)-[permission]->(resource)
  where user.type == "User" and resource.type == "Database"
  project UserName = user.name, ResourceName = resource.name, Permission = permission.type

Consultar um instantâneo específico

O exemplo a seguir consulta um instantâneo específico do gráfico:

graph("SecurityGraph", "Snapshot_2025_05_01")
| graph-match (attacker)-[attacks]->(target)-[connects]->(system)
  where attacker.name == "MaliciousActor"
  project Attacker = attacker.name, Target = target.name, System = system.name

Consulta com sintaxe de parâmetro nomeado

O exemplo a seguir usa a sintaxe do parâmetro nomeado para especificar um instantâneo:

graph("SecurityGraph", snapshot="Snapshot_2025_05_01")
| graph-shortest-paths (start)-[e*1..20]->(end)
  where start.name == "Alice" and end.name == "Database"
  project PathLength = array_length(e), Path = e

Criar um gráfico transitório a partir do modelo

O exemplo a seguir cria um gráfico transitório do modelo, semelhante ao make-graph operador:

graph("SecurityGraph", true)
| graph-match (user)-[permission]->(resource)
  where user.type == "User" and resource.type == "Database"
  project UserName = user.name, ResourceName = resource.name, Permission = permission.type

Usar false para especificar o snapshot mais recente

O exemplo a seguir especifica false explicitamente o uso do instantâneo mais recente, que é equivalente a omitir o segundo parâmetro:

graph("SecurityGraph", false)
| graph-match (user)-[permission]->(resource)
  where user.type == "User" and resource.type == "Database"
  project UserName = user.name, ResourceName = resource.name, Permission = permission.type

Conteúdo relacionado

• Visão geral da semântica do gráfico
• Visão geral de gráficos persistentes
• Visão geral do modelo gráfico
• Visão geral dos instantâneos do gráfico
• Operadores de gráficos