Trabalhar com visualizações do Spanner Graph

Esta página descreve como trabalhar com visualizações do Spanner Graph. Uma visualização do Spanner Graph pode mostrar os elementos do gráfico retornados por uma consulta ou os elementos de um esquema de gráfico. As visualizações ajudam a entender como os pontos de dados (nós) estão conectados (arestas). Embora uma tabela com centenas de pontos de dados seja difícil de interpretar, a visualização de gráfico pode revelar padrões, dependências e anomalias.

Visualizar os resultados da consulta do Spanner Graph

Para visualizar os resultados da consulta do Spanner Graph no Spanner Studio, a consulta precisa retornar elementos de gráfico no formato JSON usando a função SAFE_TO_JSON ou TO_JSON. Além disso, recomendamos retornar caminhos de gráfico em vez de retornar nós e arestas individualmente. Os benefícios de retornar aos caminhos incluem:

  • Os caminhos contêm dados completos de nós e arestas. Alguns nós e arestas intermediários em uma visualização de uma consulta complexa podem não estar disponíveis se você retornar nós e arestas individuais.

  • Se você retornar caminhos, a instrução RETURN poderá ser menos complexa do que se você retornar nós e arestas individualmente.

O exemplo de consulta a seguir retorna os caminhos das transferências de conta que podem ser visualizados:

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

Depois que você executa uma consulta, a visualização aparece na área de resultados da consulta. O painel de detalhes mostra um resumo dos rótulos de nó e de aresta com as contagens de cada um. Clique em um nó ou borda para navegar pelo gráfico e conferir propriedades, vizinhos e conexões, conforme mostrado na captura de tela a seguir. Você também pode conferir os resultados da consulta como uma tabela ou alternar para uma visualização do esquema de gráfico.

Botão de ativação/desativação do resultado da consulta.

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

Escolher um layout de visualização do Spanner Graph

As seguintes opções de layout estão disponíveis no menu do painel de visualização:

  • Layout de força (padrão): apresenta os nós como pontos que se repelem, enquanto os nós conectados são puxados juntos, simulando forças físicas como o magnetismo, para criar um layout visualmente intuitivo.
  • Hierárquica: posiciona os nós para gerar uma hierarquia visual com base na conectividade.
  • Sequência: posiciona os nós para gerar uma sequência visual com base na conectividade.
  • Mostrar rótulos: mostra todos os rótulos de nó e de aresta no gráfico, independentemente do nível de zoom.

Resolver problemas de visualizações

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

Uma visualização não aparece para uma consulta do Spanner Graph

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

Causa possível: a consulta não retorna elementos de gráfico no formato JSON. Exemplo:

  • A consulta a seguir não pode ser visualizada porque retorna 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
  • A consulta a seguir não pode ser visualizada porque retorna valores de propriedade:
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name

Solução recomendada:

Retorne elementos de gráfico no formato JSON usando SAFE_TO_JSON ou TO_JSON. Para mais informações, consulte Visualizar resultados de consulta do Spanner Graph.

Os resultados da consulta são parcialmente visualizados

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

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

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

Um nó ou aresta aparece com um rótulo inesperado

Problema: um nó ou uma aresta na visualização de gráfico mostra um rótulo inesperado.

Possível causa: o nó ou a aresta tem vários rótulos. Uma visualização de gráfico do Spanner pode mostrar um rótulo para cada nó e aresta. Se um nó ou aresta tiver mais de um rótulo, o primeiro será mostrado na visualização.

Solução recomendada: nenhuma. Não é possível mudar o rótulo que aparece.

Alguns elementos do gráfico não estão disponíveis em uma visualização

Problema: uma visualização inclui todos os nós e bordas retornados, mas alguns dos elementos do gráfico estão ausentes.

Possível causa: a consulta usada para criar a visualização retorna nós e arestas individuais em vez de um caminho de gráfico.

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

A seguir