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.
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?
- Saiba como configurar e consultar o Spanner Graph.
- Saiba mais sobre as consultas de gráficos do Spanner.
- Saiba mais sobre os esquemas de gráficos do Spanner.
- Saiba mais sobre as integrações de visualização de gráficos do Spanner.