Tutorial: Consultar o grafo usando GQL

Nesta etapa do tutorial, você consulta seu grafo usando GQL (Linguagem de Consulta do Graph) no editor de código. O GQL fornece recursos de consulta avançados para análise e padrões de grafo complexos.

Alternar para o modo editor de código

Siga estas etapas para alternar para o editor de código e começar a consultar seu grafo usando GQL:

  1. Vá para a página inicial do grafo.

  2. Selecione o editor de código no menu superior.

    Captura de tela mostrando o resultado da seleção do editor de código.

Executar uma consulta básica

  1. Insira uma consulta GQL no campo de entrada. Por exemplo, conte todos os pedidos:

    MATCH (n:`Order`) RETURN count(n) AS num_orders

  2. Selecione Executar consulta para executar a consulta.

Essa consulta localiza todos os nós com o Order rótulo, os conta e retorna o total como num_orders. É uma maneira simples de confirmar que o grafo tem dados e que a contagem corresponde ao número de linhas de pedido que você carregou. A imagem a seguir mostra o resultado da consulta:

Captura de tela mostrando o resultado da execução de uma consulta GQL para contar todos os pedidos.

Recriar a consulta do construtor de consultas no GQL

Na etapa anterior do tutorial, você usou o construtor de consultas para localizar quais produtos um cliente específico comprou. Aqui está a mesma consulta escrita em GQL:

MATCH (c:Customer)-[:purchases]->(o:`Order`)-[:`contains`]->(p:`Product`)
FILTER c.fullName = 'Carla Adams'
RETURN c.fullName, o, p.productName

Esta consulta:

  1. Corresponde ao padrão Customer → purchases → Order → contains → Product
  2. Filtros para a cliente chamada "Carla Adams"
  3. Retorna o nome completo do cliente, os detalhes do pedido e os nomes do produto

A imagem a seguir mostra o resultado da consulta (apenas uma parte dos dados retornados é mostrada).

Captura de tela mostrando o resultado da execução de uma consulta GQL para localizar produtos comprados por Carla Adams.

Executar uma consulta complexa

Você pode executar consultas mais complexas que combinam padrões de grafo correspondentes, filtragem, agregação, classificação e limitação:

MATCH (v:Vendor)-[:produces]->(p:`Product`)->(sc:`ProductSubcategory`)->(c:`ProductCategory`), 
      (o:`Order`)-[:`contains`]->(p)
FILTER c.categoryName = 'Clothing'
LET vendorName = v.vendorName, subCategoryName = sc.subCategoryName
RETURN vendorName, subCategoryName, count(DISTINCT p) AS num_products, count(o) AS num_orders
GROUP BY vendorName, subCategoryName
ORDER BY num_orders DESC
LIMIT 5

Esta consulta:

  1. Corresponde a um padrão que conecta fornecedores a produtos através da cadeia de suprimentos e conecta pedidos a produtos.
  2. Filtros para produtos na Clothing categoria.
  3. Define variáveis para nomes de fornecedor e subcategoria.
  4. Retorna o nome do fornecedor, o nome da subcategoria, a contagem de produtos distintos e a contagem de pedidos.
  5. Agrupa os resultados por fornecedor e subcategoria.
  6. Ordena os resultados pelo número de pedidos em ordem decrescente.
  7. Limita os resultados aos 5 primeiros.

Em resumo, ele mostra os cinco principais fornecedores que fornecem produtos na Clothing categoria, juntamente com quantos produtos eles fornecem e quantos pedidos esses produtos têm.

Captura de tela mostrando o resultado da execução de uma consulta GQL para localizar os cinco principais fornecedores que fornecem produtos na categoria Roupas.

Conteúdo relacionado

Para obter mais informações sobre o suporte à linguagem GQL, consulte:

Próxima etapa

Limpar recursos do tutorial

  • Last updated on