Visualizar gráficos

Para solicitar suporte ou enviar feedback sobre esse recurso, envie um e-mail para bq-graph-preview-support@google.com.

As visualizações do BigQuery Graph mostram os elementos do gráfico retornados por uma consulta ou os elementos de um esquema de gráfico. É possível visualizar gráficos em um ambiente de notebook, como o BigQuery Studio, Google Colab, ou Jupyter Notebook.

Uma visualização ajuda a entender como os pontos de dados (nós) estão conectados (bordas). Embora uma tabela de 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 resultados de consulta e esquemas em um ambiente de notebook

É possível visualizar resultados de consultas de gráficos e esquemas de gráficos em ambientes de notebook, como o BigQuery Studio, o Google Colab e o Jupyter Notebook. A visualização é implementada como um IPython Magics.

Visualizar resultados de consultas de gráficos

Para visualizar os resultados da consulta em um notebook, siga estas etapas:

  1. Em uma célula do notebook, execute o seguinte comando para instalar a biblioteca de magias mais recente do BigQuery:

    !pip install bigquery_magics==0.12.1

  2. No ambiente do notebook, verifique se você instalou a biblioteca de cliente do BigQuery Graph.

  3. Em uma célula do notebook, use o comando mágico %%bigquery --graph seguido da consulta GQL. A consulta precisa retornar elementos de gráfico no formato JSON usando a TO_JSON função. Recomendamos retornar caminhos de gráficos em vez de nós e bordas individuais. Retornar caminhos oferece os seguintes benefícios:

    • Os caminhos contêm dados completos de nós e bordas. Se você retornar nós e bordas individuais, alguns nós e bordas intermediários na visualização de uma consulta complexa poderão não estar disponíveis.

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

  4. Execute a célula. A visualização é mostrada na área de saída da célula.

A consulta de exemplo a seguir encontra uma pessoa, as contas dela e os empréstimos pagos e, em seguida, retorna os resultados em um notebook:

%%bigquery --graph
GRAPH graph_db.FinGraph
MATCH
  p = ((person:Person {name: "Dana"})-[own:Owns]->
  (account:Account)-[transfer:Transfers]->(acount2:Account)<-[own2:Owns]-(person2:Person))
RETURN
  TO_JSON(p) AS path;

Depois de executar uma consulta, a área de saída mostra a visualização. O painel de detalhes mostra um resumo dos rótulos de nós e bordas com contagens para cada um. Clique em um nó ou uma borda para navegar pelo gráfico e visualizar propriedades, vizinhos e conexões. A imagem a seguir mostra propriedades, vizinhos e conexões.

Visualização dos resultados da consulta.

Visualizar um esquema do BigQuery Graph

A estrutura de um gráfico, incluindo nós, bordas, rótulos e propriedades, é definida pelo esquema, que mapeia dados em tabelas do BigQuery para elementos de gráfico. A definição do gráfico é armazenada em um esquema criado usando tabelas de entrada.

É possível visualizar gráficos criados com um esquema. A visualização do esquema ajuda a entender a estrutura do gráfico, incluindo os tipos de nós e bordas que ele contém e as conexões deles. Isso pode ser útil para gráficos complexos, porque oferece uma visão clara das relações que podem ser difíceis de inferir nas instruções DDL usadas para criar o gráfico. A imagem a seguir mostra um exemplo de visualização de esquema de gráfico.

Visualização de um esquema de gráfico.

Para ver uma visualização de um esquema do BigQuery Graph em um notebook, siga estas etapas:

  1. Em uma célula do notebook, execute o seguinte comando para instalar a biblioteca de magias do BigQuery:

    !pip install bigquery_magics==0.12.1

  2. No ambiente do notebook, verifique se você instalou a biblioteca de cliente do BigQuery Graph.

  3. Em uma célula do notebook, use o comando mágico %%bigquery --graph seguido da consulta GQL. A consulta precisa retornar elementos de gráfico no formato JSON usando a TO_JSON função.

  4. Execute a célula. A visualização é mostrada na área de saída da célula.

  5. Na saída da visualização, clique em esquema Visualização do esquema.

Resolver problemas de visualizações do BigQuery Graph

As informações a seguir podem ajudar você a resolver problemas e entender os problemas e o comportamento da visualização do BigQuery Graph.

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

Problema: você executa uma consulta do BigQuery Graph, mas ela aparece apenas no formato de tabela.

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

Por exemplo, a consulta a seguir não pode ser visualizada porque retorna valores de propriedade em vez de elementos de gráfico no formato JSON:

GRAPH graph_db.FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name;

Solução:

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

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

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

Possível causa: a consulta retorna mais de 2 MB de dados. Uma visualização de consulta pode mostrar um máximo de 2 MB de dados.

Solução: simplifique a consulta para retornar menos de 2 MB de dados.

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

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

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

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

A seguir