Usar visualizaciones de Spanner Graph

Las visualizaciones de Spanner Graph muestran los elementos de gráfico devueltos por una consulta o los elementos de un esquema de gráfico. Una visualización te ayuda a entender cómo se conectan los puntos de datos (nodos) (aristas). Aunque una tabla con cientos de puntos de datos puede ser difícil de interpretar, su visualización en forma de gráfico puede revelar patrones, dependencias y anomalías.

Visualizar los resultados de las consultas de Spanner Graph

Para visualizar los resultados de las consultas de Spanner Graph en Spanner Studio, la consulta debe devolver elementos de gráfico en formato JSON mediante la función SAFE_TO_JSON o TO_JSON. Te recomendamos que devuelvas rutas de gráficos en lugar de nodos y aristas por separado. Devolver rutas ofrece las siguientes ventajas:

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

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

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

GRAPH FinGraph
MATCH result_paths = (account:Account {is_blocked: True})-[:Transfers]->(dest_account:Account)
RETURN SAFE_TO_JSON(result_paths) AS result_paths

Después de ejecutar una consulta, el área de resultados de la consulta muestra la visualización. El panel de detalles muestra un resumen de las etiquetas de los nodos y los bordes, así como el número de cada una. Haga clic en un nodo o en una arista para desplazarse por el gráfico y ver las propiedades, los vecinos y las conexiones, como se muestra en la siguiente captura de pantalla. También puedes ver los resultados de la consulta en una tabla o cambiar a una visualización del esquema del gráfico subyacente.

Botón para activar o desactivar el resultado de la consulta.

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

Elegir un diseño de visualización de gráfico de Spanner

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

  • Forzar diseño (opción predeterminada): presenta los nodos como puntos que se repelen entre sí, mientras que los nodos conectados se atraen, simulando fuerzas físicas para crear un diseño visualmente intuitivo.

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

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

  • Mostrar etiquetas: muestra todas las etiquetas de los nodos y los bordes del gráfico en todos los niveles de zoom.

Visualizar un esquema de Spanner Graph

La estructura de un gráfico de Spanner, como sus nodos, aristas, etiquetas y propiedades, se define mediante su esquema, que asigna elementos del gráfico a datos de tablas de Spanner. La definición del gráfico se almacena en un esquema que se crea mediante tablas de entrada o se deduce de los datos cuando se usa la gestión de datos sin esquema.

Puedes visualizar los gráficos que crees con un esquema o los que utilicen la gestión de datos sin esquema. Visualizar el esquema te ayuda a comprender la estructura de tu gráfico, incluidos los tipos de nodos y aristas que contiene, así como la forma en que 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 ver una visualización de un esquema de gráfico de Spanner en la consola, haga una de las siguientes acciones:Google Cloud

  • Cuando veas una visualización de los resultados de una consulta de gráfico de Spanner, haz clic en Cambiar a vista de esquema en la pestaña Resultados del panel de resultados de la consulta.

    Botón para cambiar a la vista de esquema.

  • En el panel Explorador, haga clic en Ver esquema en un gráfico de Spanner:

    1. En la Google Cloud consola, abre la página Spanner.

      Ir a Spanner

    2. Selecciona una instancia de la lista.

    3. Selecciona una base de datos.

    4. En el menú de navegación, haz clic en Spanner Studio. En el panel Explorador se muestra una lista de los objetos de la base de datos.

    5. Haz clic en Ver acciones en un gráfico de Spanner y, a continuación, en Ver esquema.

Solucionar problemas con las visualizaciones de Spanner Graph

La siguiente información puede ayudarte a solucionar problemas y a entender los problemas y el comportamiento de la visualización de gráficos de Spanner.

No aparece ninguna visualización para una consulta de Spanner Graph

Problema: ejecutas una consulta de Spanner Graph y solo aparece en formato de tabla.

Posible causa: la consulta no devuelve elementos de gráfico en formato JSON. Por ejemplo:

  • La siguiente consulta no se puede visualizar porque devuelve nodos e identificadores de aristas:
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN person.id as person_id, account.id as account_id
  • La siguiente consulta no se puede visualizar porque devuelve valores de propiedad:
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name

Solución recomendada:

Devuelve elementos de gráfico en formato JSON mediante SAFE_TO_JSON o TO_JSON. Para obtener más información, consulta Visualizar los resultados de las consultas de gráficos de Spanner.

Los resultados de las consultas de Spanner Graph se visualizan parcialmente

Problema: En la visualización de los resultados de una consulta solo se muestra una parte de ellos.

Causa posible: la consulta devuelve más de 10 MB de datos. Una visualización de consulta puede mostrar hasta 10 MB de datos.

Solución recomendada: simplifica la consulta para que devuelva menos de 10 MB de datos.

Una visualización de gráfico de Spanner incluye un nodo o un borde con una etiqueta inesperada

Problema: Un nodo o una arista de una visualización de gráfico de Spanner muestra una etiqueta inesperada.

Posible causa: el nodo o la arista tienen varias etiquetas. Una visualización de gráfico de Spanner puede mostrar una etiqueta por cada nodo y arista. Si un nodo o un borde tiene más de una etiqueta, se muestra la primera en la visualización.

Solución recomendada: ninguna. No puedes cambiar la etiqueta que se muestra.

Algunos elementos de los gráficos no se muestran en una visualización de gráficos de Spanner

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

Causa posible: la consulta usada para crear la visualización de gráfico de Spanner devuelve nodos y aristas individuales en lugar de una ruta de gráfico.

Solución recomendada: actualiza la consulta para que devuelva una ruta de gráfico.

Siguientes pasos