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 resultados que devuelve una consulta de un esquema de gráfico. Puedes visualizar gráficos en BigQuery Studio o en un entorno de notebook, como Google Colab o Jupyter Notebook.

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

Visualiza los resultados de las consultas de BigQuery Graph

Puedes usar la Google Cloud consola para visualizar los resultados de las consultas de BigQuery Graph en BigQuery Studio. Para visualizar una consulta con BigQuery Graph, la consulta debe devolver elementos de gráfico en formato JSON con la TO_JSON función. Te recomendamos que devuelvas rutas de acceso de gráficos en lugar de nodos y aristas individuales. Devolver rutas de acceso ofrece los siguientes beneficios:

  • Las rutas de acceso contienen datos completos de nodos y aristas. Es posible que algunos nodos y aristas intermedios en una visualización de una consulta compleja no estén disponibles si devuelves nodos y aristas individuales.

  • Si devuelves rutas de acceso, tu instrucción RETURN puede ser menos compleja que si devuelves nodos y aristas individuales.

La siguiente consulta de ejemplo devuelve las rutas de acceso de las transferencias de cuentas, que puedes visualizar:

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

Para visualizar los resultados, en el panel Resultados de la consulta , haz clic en Gráfico. El panel de detalles muestra un resumen de las etiquetas de nodos y aristas con recuentos para cada una. Haz clic en un nodo o una arista para navegar por el gráfico y ver las propiedades, los vecinos y las conexiones. Como alternativa, puedes ver los resultados de la consulta como una tabla o cambiar a una visualización del esquema de gráfico subyacente.

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

Para obtener más información, consulta Devuelve elementos de gráfico como JSON.

Elige opciones de visualización de resultados de consultas

Puedes actualizar la forma en que aparecen los nodos en una visualización de consulta. Por ejemplo, puedes especificar el diseño de la visualización de la consulta, el color de los nodos y qué propiedad aparece en cada nodo.

Las actualizaciones de la visualización de los resultados de la consulta son para la sesión actual de visualización de resultados de la consulta. Las actualizaciones de las opciones de visualización no persisten si vuelves a ejecutar la misma consulta.

Elige un diseño para una visualización de BigQuery Graph

El menú del panel de visualización proporciona las siguientes opciones de diseño:

  • Diseño forzado (predeterminado): Presenta los nodos como puntos que se repelen entre sí, mientras que los nodos conectados se unen, lo que simula fuerzas físicas para crear un diseño visualmente intuitivo.

  • Jerárquico: Posiciona los nodos para crear una jerarquía visual basada en la conectividad.

  • Secuencial: Posiciona los nodos para crear una secuencia visual basada en la conectividad.

  • Mostrar etiquetas: Muestra todas las etiquetas de nodos y aristas en el gráfico en todos los niveles de zoom.

Elige la propiedad de nodo o arista que deseas mostrar

De forma predeterminada, un nodo o una arista muestra su primera propiedad. Si deseas que un nodo o una arista muestre una propiedad diferente, haz lo siguiente:

  1. Cuando veas una visualización de los resultados de una consulta de BigQuery Graph, haz clic en Cambiar a la vista de esquema en la pestaña Resultados del panel de resultados de la consulta.

    Botón para cambiar a la vista de esquema.

  2. En la visualización del esquema, haz clic en un nodo o una arista del tipo que deseas actualizar.

  3. En el panel de detalles que aparece para el nodo o la arista seleccionados, haz clic en la propiedad que deseas mostrar. Todos los nodos o aristas de los resultados de la consulta que sean del tipo de nodo o arista que seleccionaste muestran la propiedad que seleccionaste.

Elige el color de tus nodos

  1. Cuando veas una visualización de los resultados de una consulta de BigQuery Graph, haz clic en Cambiar a la vista de esquema en la pestaña Resultados del panel de resultados de la consulta.

  2. En la visualización del esquema, haz clic en un nodo del tipo que deseas actualizar.

  3. En el panel de detalles que aparece para el nodo seleccionado, haz clic en Opciones de visualización de nodos.

  4. Haz clic en un color. Todos los nodos de los resultados de la consulta que sean del tipo de nodo que seleccionaste se muestran con el color que elijas.

Elige qué nodos se muestran

Para elegir qué nodos se muestran en una visualización, haz lo siguiente:

  1. En la visualización de la consulta, haz clic con el botón derecho en un nodo.

  2. Haz clic en una de las siguientes opciones de menú para modificar el estado visible del gráfico:

    • Expandir renderiza los nodos adyacentes recorriendo todas las aristas entrantes, las aristas salientes o filtrando por un tipo de arista específico.

    • Contraer poda la vista actual ocultando todos los nodos conectados al nodo de destino con aristas entrantes, aristas salientes o un tipo de arista específico.

    • Ocultar nodo quita el nodo de destino de la vista actual.

    • Mostrar solo vecinos oculta todos los nodos del gráfico, excepto el nodo de destino y los que están conectados directamente a él.

    • Destacar nodo destaca el nodo de destino.

Visualiza un esquema de BigQuery Graph

La estructura de un gráfico, incluidos sus nodos, aristas, etiquetas y propiedades, se define mediante su esquema, que asigna elementos de gráfico a datos en tablas de BigQuery. 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 aristas que contiene y cómo se conectan. 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 solo a partir de las instrucciones DDL.

Para visualizar un esquema de gráfico, sigue estos pasos:

  1. En BigQuery Studio, ve al panel Explorador.
  2. Expande el conjunto de datos que contiene tu gráfico, expande Gráficos y, luego, selecciona tu gráfico.
  3. Haz clic en la pestaña Gráfico.

Visualiza los resultados de las consultas y los esquemas en un entorno de notebook

Puedes visualizar los resultados de las consultas de gráficos y los esquemas 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 las consultas de gráficos

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

  1. En una celda del notebook, ejecuta el siguiente comando para instalar la biblioteca de magias 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 devolver elementos de gráfico en formato JSON con la TO_JSON función. Te recomendamos que devuelvas rutas de acceso de gráficos en lugar de nodos y aristas individuales. Devolver rutas de acceso ofrece los siguientes beneficios:

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

    • Si devuelves rutas de acceso, tu instrucción RETURN es menos compleja que si devuelves nodos y aristas 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 las transferencias entre cuentas, y luego devuelve los resultados en un notebook:

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

Después de ejecutar una consulta, el área de resultado muestra la visualización. El panel de detalles muestra un resumen de las etiquetas de nodos y aristas con recuentos para cada una. Haz clic en un nodo o una arista 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, aristas, 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 aristas 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 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 magias 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 devolver 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 los problemas y el comportamiento de la 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 devuelve elementos de gráfico en formato JSON.

Por ejemplo, la siguiente consulta no se puede visualizar porque devuelve 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:

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

Los resultados de las consultas de BigQuery Graph se visualizan parcialmente

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

Causa posible: Si usas una visualización de notebook, la consulta devuelve más de 2 MB de datos. Una visualización de notebook tiene un límite de 2 MB, mientras que la Google Cloud visualización de la consola no tiene un límite máximo.

Solución: Si usas un notebook, simplifica la consulta para devolver menos de 2 MB de datos o usa la Google Cloud consola para visualizar los resultados.

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

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

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

Solución: Actualiza la consulta para devolver una ruta de acceso de gráfico.

¿Qué sigue?