Visualiza gráficos

Para solicitar asistencia o enviar comentarios sobre esta función, envía un correo electrónico a bq-graph-preview-support@google.com.

Las visualizaciones de BigQuery Graph muestran los elementos del gráfico que muestra una consulta o los elementos de un esquema de gráfico. Puedes visualizar gráficos en un entorno de notebook, como BigQuery Studio, Google Colab, o Jupyter Notebook.

Una visualización te ayuda a comprender cómo se conectan los puntos de datos (nodos) (bordes). Si bien una tabla de cientos de puntos de datos puede ser difícil de interpretar, su visualización de gráfico puede revelar patrones, dependencias y anomalías.

Visualiza esquemas y resultados de consultas en un entorno de notebook

Puedes visualizar esquemas y resultados de consultas de gráficos en entornos de notebook, como BigQuery Studio, Google Colab y Jupyter Notebook. La visualización se implementa como un IPython Magics.

Visualiza los resultados de consultas de gráficos

Para visualizar los resultados de consultas en un notebook, sigue estos pasos:

  1. En una celda del notebook, ejecuta el siguiente comando para instalar la biblioteca de magics de BigQuery más reciente:

    !pip install bigquery_magics==0.12.1

  2. En tu entorno de notebook, asegúrate de tener instalada la biblioteca cliente de BigQuery Graph.

  3. En una celda del notebook, usa el comando mágico %%bigquery --graph seguido de tu consulta de GQL. La consulta debe mostrar elementos de gráfico en formato JSON con la TO_JSON función. Te recomendamos que muestres rutas de gráficos en lugar de nodos y bordes individuales. Mostrar rutas proporciona los siguientes beneficios:

    • Las rutas contienen datos completos de nodos y bordes. Si muestras nodos y bordes individuales, es posible que algunos nodos y bordes intermedios en la visualización de una consulta compleja no estén disponibles.

    • Si muestras rutas, tu instrucción RETURN es menos compleja que si muestras nodos y bordes individuales.

  4. Ejecuta la celda. La visualización se muestra en el área de salida de la celda.

La siguiente consulta de ejemplo busca una persona, sus cuentas y los préstamos pagados, y luego muestra los resultados en un 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;

Después de ejecutar una consulta, el área de salida muestra la visualización. El panel de detalles muestra un resumen de las etiquetas de nodos y bordes con recuentos para cada una. Haz clic en un nodo o un borde para navegar por el gráfico y ver las propiedades, los vecinos y las conexiones. En la siguiente imagen, se muestran las propiedades, los vecinos y las conexiones.

Visualización de los resultados de la búsqueda.

Visualiza un esquema de BigQuery Graph

La estructura de un gráfico, incluidos sus nodos, bordes, etiquetas y propiedades, se define mediante su esquema, que asigna datos en tablas de BigQuery a elementos de gráfico. La definición del gráfico se almacena en un esquema que creas con tablas de entrada.

Puedes visualizar los gráficos que creas con un esquema. Visualizar el esquema te ayuda a comprender la estructura del gráfico, incluidos los tipos de nodos y bordes que contiene, y sus conexiones. Esto puede ser útil para gráficos complejos, ya que proporciona una vista clara de las relaciones que podrían ser difíciles de inferir a partir de las instrucciones DDL que usaste para crear el gráfico. En la siguiente imagen, se muestra un ejemplo de una visualización de esquema de gráfico.

Visualización de un esquema de gráfico.

Para ver una visualización de un esquema de BigQuery Graph en un notebook, sigue estos pasos:

  1. En una celda del notebook, ejecuta el siguiente comando para instalar la biblioteca de magics de BigQuery:

    !pip install bigquery_magics==0.12.1

  2. En tu entorno de notebook, asegúrate de tener instalada la biblioteca cliente de BigQuery Graph.

  3. En una celda del notebook, usa el comando mágico %%bigquery --graph seguido de tu consulta de GQL. La consulta debe mostrar elementos de gráfico en formato JSON con la TO_JSON función.

  4. Ejecuta la celda. La visualización se muestra en el área de salida de la celda.

  5. En el resultado de la visualización, haz clic en esquema Vista de esquema.

Soluciona problemas de visualizaciones de BigQuery Graph

La siguiente información puede ayudarte a solucionar problemas y comprender el comportamiento y los problemas de visualización de BigQuery Graph.

No aparece una visualización para una consulta de BigQuery Graph

Problema: Ejecutas una consulta de BigQuery Graph, pero solo aparece en formato de tabla.

Causa posible: La consulta no muestra elementos de gráfico en formato JSON.

Por ejemplo, la siguiente consulta no se puede visualizar porque muestra valores de propiedad en lugar de elementos de gráfico en formato JSON:

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

Solución:

Muestra elementos de gráfico en formato JSON con TO_JSON. Para obtener más información, consulta Visualiza los resultados de consultas de BigQuery Graph.

Los resultados de consultas de BigQuery Graph se visualizan parcialmente

Problema: Una visualización de resultados de consultas muestra solo una parte de los resultados de la consulta.

Causa posible: La consulta muestra más de 2 MB de datos. Una visualización de consulta puede mostrar un máximo de 2 MB de datos.

Solución: Simplifica la consulta para que muestre menos de 2 MB de datos.

Algunos elementos de gráfico no se muestran en una visualización de BigQuery Graph

Problema: Una visualización incluye todos los nodos y bordes que se muestran, pero no se muestran algunos elementos de gráfico.

Causa posible: La consulta que se usó para crear la visualización de BigQuery Graph muestra nodos y bordes individuales en lugar de una ruta de gráfico.

Solución: Actualiza la consulta para que muestre una ruta de gráfico.

¿Qué sigue?