Use visualizações do gráfico do Spanner

As visualizações de gráficos do Spanner mostram 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. A devolução de caminhos oferece 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 intervalo

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.

Visualize um esquema de gráfico do Spanner

A estrutura de um gráfico do Spanner, como os respetivos nós, arestas, etiquetas e propriedades, é definida pelo respetivo esquema, que mapeia os elementos do gráfico para os dados nas tabelas do Spanner. A definição do gráfico é armazenada num esquema que cria através de tabelas de entrada ou é evidente a partir dos dados quando usa a gestão de dados sem esquema.

Pode visualizar gráficos criados com um esquema ou gráficos que usam a gestão de dados sem esquema. A visualização do esquema ajuda a compreender a estrutura do seu gráfico, incluindo os tipos de nós e arestas que contém e como se ligam. Isto pode ser útil para gráficos complexos, oferecendo uma vista clara das relações que podem ser difíceis de inferir apenas a partir de declarações DDL.

Pode ver uma visualização de um esquema do Spanner Graph na Google Cloud consola através de uma das seguintes ações:

  • Quando estiver a ver uma visualização dos resultados de uma consulta do Spanner Graph, clique em Mudar para vista de esquema no separador Resultados do painel de resultados da consulta.

    Botão Mudar para vista de esquema.

  • Clique em Ver esquema num gráfico do Spanner no painel Explorador:

    1. Na Google Cloud consola, abra a página Spanner.

      Aceda ao Spanner

    2. Selecione uma instância na lista.

    3. Selecione uma base de dados.

    4. No menu de navegação, clique em Spanner Studio. O painel Explorador apresenta uma lista dos objetos na sua base de dados.

    5. Clique em Ver ações num gráfico do Spanner e, de seguida, clique em Ver esquema.

Resolva problemas de visualizações do gráfico 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 de 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 de 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?