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

Puede usar la Google Cloud consola para visualizar los resultados de las consultas de Spanner Graph en Spanner Studio. Para visualizar una consulta con Spanner Graph, 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 puede 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 opciones de visualización de los resultados de la consulta

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 la propiedad que aparece en cada nodo.

Las actualizaciones de la visualización de los resultados de las consultas se aplican a la sesión actual. Los cambios que hagas en las opciones de visualización no se conservarán si vuelves a ejecutar la misma consulta.

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:

  • Diseño de fuerza (predeterminado): 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 nodos y aristas del gráfico en todos los niveles de zoom.

Elige la propiedad del nodo que quieras mostrar.

De forma predeterminada, un nodo muestra su primera propiedad. Si quieres que un nodo muestre otra propiedad, haz lo siguiente:

  1. 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.

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

  3. En el panel de detalles que aparece del nodo seleccionado, haga clic en la propiedad que quiera mostrar. En todos los nodos de los resultados de la consulta que sean del tipo de nodo que ha seleccionado se muestra la propiedad que ha seleccionado.

Elegir el color de los nodos

  1. 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.

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

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

  4. Haz clic en un color o introduce un código de color hexadecimal personalizado. Todos los nodos de los resultados de la consulta que sean del tipo de nodo que has seleccionado se muestran con el color que elijas.

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.

  • Haga clic en Ver esquema en un gráfico de Spanner del explorador de objetos:

    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 de objetos se muestra una lista de los objetos de la base de datos.

    5. Haga 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.

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 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