Trabalhe com uma visualização de gráficos do Spanner

Esta página descreve como trabalhar com uma visualização de grafos do Spanner. Uma visualização de gráfico do Spanner pode mostrar os elementos do gráfico devolvidos por uma consulta ou os elementos de um esquema de gráfico. Uma visualização ajuda a compreender como os pontos de dados (nós) estão ligados (arestas). Embora uma tabela com centenas de pontos de dados possa ser difícil de interpretar, a respetiva visualização gráfica pode revelar padrões, dependências e anomalias.

Visualize os resultados da consulta do Spanner Graph

Para visualizar os resultados da consulta do Spanner Graph no Spanner Studio, a consulta tem de devolver elementos do gráfico no formato JSON através da função SAFE_TO_JSON ou TO_JSON. Recomendamos que devolva caminhos de grafos em vez de devolver nós e arestas individualmente. Os caminhos de retorno oferecem as seguintes vantagens:

  • Os caminhos contêm dados completos de nós e arestas. Alguns nós e arestas intermédios numa visualização de uma consulta complexa podem não estar disponíveis se devolver nós e arestas individuais.

  • Se devolver caminhos, a sua declaração RETURN pode ser menos complexa do que se devolver nós e arestas individualmente.

A seguinte consulta de exemplo devolve os caminhos das transferências de contas, que pode visualizar:

GRAPH FinGraph
MATCH result_paths = (account:Account {is_blocked: True})-[:Transfers]->(dest_account:Account)
RETURN SAFE_TO_JSON(result_paths) AS result_paths

Depois de executar uma consulta, a área de resultados da consulta apresenta a visualização. O painel de detalhes mostra um resumo das etiquetas de nós e arestas com contagens para cada uma. Clique num nó ou numa aresta para navegar no gráfico e ver propriedades, vizinhos e ligações, como mostra a captura de ecrã seguinte. Em alternativa, pode ver os resultados da consulta como uma tabela ou alternar para uma visualização do esquema do gráfico subjacente.

Botão para ativar/desativar o resultado da consulta.

Para mais informações, consulte o artigo Devolva elementos do gráfico como JSON.

Escolha um esquema de visualização do gráfico de extensão

O menu no painel de visualização oferece as seguintes opções de esquema:

  • Forçar esquema (predefinição): apresenta os nós como pontos que se repelem entre si, enquanto os nós ligados se juntam, simulando forças físicas para criar um esquema visualmente intuitivo.

  • Hierárquico: posiciona os nós para criar uma hierarquia visual com base na conetividade.

  • Sequencial: posiciona os nós para criar uma sequência visual com base na conetividade.

  • Mostrar etiquetas: apresenta todas as etiquetas de nós e arestas no gráfico em todos os níveis de zoom.

Resolva problemas de visualizações de gráficos do Spanner

As informações seguintes podem ajudar a resolver problemas e a compreender o comportamento e os problemas de visualização do Spanner Graph.

Não é apresentada uma visualização para uma consulta do Spanner Graph

Problema: executa uma consulta do Spanner Graph e esta aparece apenas no formato de tabela.

Possível causa: a consulta não devolve elementos do gráfico no formato JSON. Por exemplo:

  • Não é possível visualizar a seguinte consulta porque devolve identificadores de nós e arestas:
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN person.id as person_id, account.id as account_id
  • Não é possível visualizar a seguinte consulta porque devolve valores de propriedades:
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name

Solução recomendada:

Devolva elementos do gráfico no formato JSON usando SAFE_TO_JSON ou TO_JSON. Para mais informações, consulte o artigo Visualize os resultados da consulta do Spanner Graph.

Os resultados da consulta do gráfico do Spanner são parcialmente visualizados

Problema: uma visualização de resultados de consultas mostra apenas uma parte dos resultados de consultas.

Possível causa: a consulta devolve mais de 10 MB de dados. Uma visualização de consulta pode apresentar até 10 MB de dados.

Solução recomendada: simplifique a consulta para que devolva menos de 10 MB de dados.

Uma visualização do gráfico do Spanner inclui um nó ou um limite com uma etiqueta inesperada

Problema: um nó ou uma aresta numa visualização de gráfico do Spanner mostra uma etiqueta inesperada.

Causa possível: o nó ou a aresta tem várias etiquetas. Uma visualização de gráfico do Spanner pode mostrar uma etiqueta para cada nó e aresta. Se um nó ou uma aresta tiver mais do que uma etiqueta, a primeira etiqueta é apresentada na visualização.

Solução recomendada: nenhuma. Não pode alterar a etiqueta apresentada.

Alguns elementos do gráfico não são apresentados numa visualização do gráfico do Spanner

Problema: uma visualização inclui todos os nós e arestas devolvidos, mas alguns dos elementos do gráfico não são apresentados.

Causa possível: a consulta usada para criar a visualização do gráfico do Spanner devolve nós e arestas individuais em vez de um caminho do gráfico.

Solução recomendada: atualize a consulta para devolver um caminho do gráfico.

O que se segue?