GQL (Graph Query Language) (visualização)

Mude de serviço usando a lista suspensa de Versões . Saiba mais sobre navegação.
Aplica-se a: ✅ Microsoft Fabric ✅ Azure Data Explorer

A GQL (Graph Query Language) permite usar a correspondência padronizada de padrões de gráficos. O GQL segue o padrão ISO GQL para consultas de banco de dados gráfico.

Introdução

Graph Query Language (GQL) é um padrão ISO emergente para consultar bancos de dados gráficos. O GQL permite que você use sintaxe semelhante a SQL para correspondência de padrões gráficos, para que seja mais fácil analisar relacionamentos em seus dados. Este artigo explica como usar o GQL, seus benefícios e principais recursos.

O GQL fornece recursos padronizados de correspondência de padrões gráficos para analisar relacionamentos em seus dados usando a sintaxe padrão ISO.

Como Começar

Para usar o GQL, você precisa:

• Uma fonte de dados de gráfico que é um modelo de gráfico ou uma função que retorna um gráfico transitório que termina com um operador de make-graph (consulte a etapa 1).
• Defina propriedades específicas de solicitação do cliente (consulte a etapa 2).

Etapa 1: Criar uma referência de gráfico

Antes de usar o GQL, crie uma fonte de dados de gráfico. Este artigo usa um operador make-graph na memória, mas recomendamos o uso de um instantâneo gráfico para cenários de produção.

.create-or-alter function G_doc() {
    let nodes = datatable(id:string, lbl:string, name:string, properties:dynamic)
    [
        "p1","Person","Alice",dynamic({"age": 25}),
        "p2","Person","Bob",dynamic({"age": 30}),
        "p3","Person","Carol",dynamic({"age": 28}),
        "p4","Person","David",dynamic({"age": 35}),
        "p5","Person","Emma",dynamic({"age": 26}),
        "c1","Company","TechCorp",,
        "c2","Company","DataSoft",,
        "c3","Company","CloudInc",,
        "ct1","City","Seattle",,
        "ct2","City","Portland",,
        "ct3","City","San Francisco",
    ];
    let edges = datatable(source:string, target:string, lbl:string, since:int)
    [
        "p1","c1","works_at",2020,
        "p2","c1","works_at",2022,
        "p3","c2","works_at",2023,
        "p4","c3","works_at",2021,
        "p5","c1","works_at",2024,
        "p1","ct1","located_at",2019,
        "p2","ct1","located_at",2021,
        "p3","ct2","located_at",2022,
        "p4","ct3","located_at",2020,
        "p5","ct2","located_at",2023,
        "c1","ct1","located_at",2015,
        "c2","ct2","located_at",2018,
        "c3","ct3","located_at",2017,
        "p1","p2","knows",2019,
        "p2","p3","knows",2021,
        "p3","p4","knows",2022,
        "p4","p5","knows",2023,
        "p1","p4","likes",2020,
        "p4","p1","likes",2020,
        "p5","p2","likes",2022
    ];
    edges
    | make-graph source --> target with nodes on id
}

Etapa 2: Configurar as propriedades de solicitação do cliente

Definir propriedades de solicitação do cliente

#crp query_language=gql

#crp query_graph_reference=G_doc()

Para usar rótulos no GQL, defina o nome da coluna do rótulo:

#crp query_graph_label_name=lbl

Definir propriedades de solicitação do cliente em programaticamente

Para acesso programático, defina estas propriedades de solicitação do cliente:

• query_language: Defina como "gql".
• query_graph_reference: Defina o nome da função do gráfico (por exemplo, "G_doc()").
• query_graph_label_name: Defina o nome da coluna do rótulo (por exemplo, "lbl").

Etapa 3: Executar consultas GQL

Depois de concluir a instalação, execute consultas GQL usando a sintaxe GQL padrão. Use os exemplos abaixo para explorar recursos básicos e avançados do GQL.

Examples

Encontre exemplos básicos de correspondência de padrões e etiquetas aqui. Para obter exemplos mais complexos, consulte Padrões de consulta GQL, exemplos e cenários comuns. Para obter documentação de referência, incluindo fundamentos e detalhes da função, consulte Referência GQL (Graph Query Language).

Exemplo de consulta GQL para correspondência básica de padrões

MATCH (n)-[e]->(n2)
RETURN COUNT(*) as CNT

Saída

A tabela a seguir mostra o resultado da consulta.

Exemplo de consulta GQL com rótulos

MATCH (p:Person)-[e]->(target)
RETURN p.name, target.name, e.lbl
ORDER BY p.name, target.name
LIMIT 2

Saída

A tabela a seguir mostra o resultado da consulta.

Conteúdo relacionado

• Referência GQL (Graph Query Language)
• Padrões de consulta GQL, exemplos e casos de uso
• Visão geral dos operadores gráficos
• operador de make-graph
• operador de correspondência gráfica
• Tutorial: Crie seu primeiro gráfico
• Referência de funções gráficas