Trabalhar com visualizações do Spanner Graph

Nesta página, descrevemos como trabalhar com visualizações de gráficos do Spanner. 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 você a entender como os pontos de dados (nós) estão conectados (arestas). Embora uma tabela com centenas de pontos de dados possa ser difícil de interpretar, a visualização do gráfico pode revelar padrões, dependências e anomalias.

Visualizar os resultados da consulta do Spanner Graph

Para visualizar os resultados da consulta de gráfico do Spanner no Spanner Studio, a consulta precisa retornar elementos de gráfico no formato JSON usando a função SAFE_TO_JSON ou TO_JSON. Recomendamos que você retorne caminhos de gráficos em vez de nós e arestas individualmente. Retornar caminhos oferece os seguintes benefícios:

  • 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.

A consulta de exemplo 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 de executar uma consulta, a área de resultados mostra a visualização. O painel de detalhes mostra um resumo dos rótulos de nós e arestas com contagens para cada um. Clique em um nó ou uma aresta para navegar pelo gráfico e ver propriedades, vizinhos e conexões, como mostra a captura de tela a seguir. Como alternativa, é possível ver os resultados da consulta como uma tabela ou alternar para uma visualização do esquema do gráfico subjacente.

Botão de alternância de resultados da consulta.

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

Escolher um layout de visualização do gráfico do Spanner

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

  • Layout de força (padrão): apresenta nós como pontos que se repelem, enquanto os nós conectados se unem, simulando forças físicas para criar um layout visualmente intuitivo.

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

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

  • Mostrar rótulos: mostra todos os rótulos de nós e arestas no gráfico em todos os níveis de zoom.

Resolver problemas com visualizações do Spanner Graph

As informações a seguir podem ajudar você a resolver problemas e entender o comportamento e os problemas de visualização do gráfico do Spanner.

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.

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

  • Não é possível visualizar a consulta a seguir porque ela 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 consultas do Spanner Graph.

Os resultados da consulta do Spanner Graph são parcialmente visualizados

Problema: uma visualização de resultados da consulta mostra apenas uma parte deles.

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.

Uma visualização de gráfico do Spanner inclui um nó ou uma aresta com um rótulo inesperado

Problema: um nó ou uma aresta em uma visualização de gráfico do Spanner 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 uma aresta tiver mais de um rótulo, o primeiro vai aparecer na visualização.

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

Alguns elementos do gráfico não são mostrados em uma visualização de gráfico do Spanner

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

Possível causa: a consulta usada para criar a visualização do gráfico do Spanner 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