Crea y administra visualmente un esquema de Spanner Graph

Versión preliminar : Administración visual de Spanner Graph

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Nota: Esta función está disponible en las ediciones Spanner Enterprise y Enterprise Plus. Para obtener más información, consulta la descripción general de las ediciones de Spanner.

En este documento, se proporciona una guía para administrar visualmente los esquemas de Spanner Graph en Spanner Studio. El modelado visual simplifica el diseño de gráficos, ya que te permite asignar nodos y bordes a través de una interfaz intuitiva en lugar de crear instrucciones DDL manuales. Esta función facilita el diseño, la comprensión y la colaboración con otras personas. Además, este enfoque aplica automáticamente las prácticas recomendadas del esquema de Spanner Graph, lo que garantiza que esté optimizado desde el principio.

Los esquemas de Spanner Graph también se pueden crear y editar con DDL. Para obtener más información sobre los esquemas de gráficos de propiedades, consulta la descripción general del esquema de Spanner Graph. Si encuentras errores cuando creas un esquema de gráfico de propiedades, consulta Solución de problemas de Spanner Graph.

Crea un gráfico

Para comenzar, navega a Spanner Studio y haz clic en Crear gráfico en la página principal. La herramienta de modelado de gráficos proporciona la flexibilidad para compilar tu gráfico de varias maneras:

• Desde cero: Diseña nodos y bordes por completo a través de la interfaz visual. Spanner genera automáticamente las instrucciones DDL necesarias y los objetos de esquema que optimizan el rendimiento.

• Desde tablas existentes: Asigna tus tablas relacionales actuales directamente a un modelo de grafo, siempre que tengan conexiones establecidas entre sí.

• Un enfoque híbrido: Modela algunos elementos desde cero mientras asignas otros de tus tablas existentes.

Nodos del modelo

Para agregar un nodo al gráfico, sigue estos pasos:

Desde cero

Cuando creas un nodo nuevo, Spanner genera automáticamente una tabla de base de datos para él. A medida que defines las propiedades y las claves del nodo, Spanner configura las columnas y las claves primarias de la tabla.

1. Abre el lienzo de modelado de gráficos en Spanner Studio.
2. Agrega un nodo al gráfico y selecciona Nuevo como su fuente de datos.
3. Asigna un nombre al nodo. La tabla que se crea para este nodo se nombra según este valor.
4. Asigna una etiqueta al nodo. De forma predeterminada, esta etiqueta coincide con el nombre del nodo, pero se puede cambiar.
5. Define las propiedades asociadas con la etiqueta, incluidos sus nombres y tipos de datos. Selecciona Es clave de elemento para al menos una propiedad para designarla como clave. Selecciona No es nulo para rechazar los valores nulos.

Desde una tabla existente

Cuando asignas un nodo a una tabla existente, Spanner usa el esquema de la tabla como base. Su etiqueta, propiedades y claves se heredan automáticamente de la tabla, pero se pueden anular.

1. Abre el lienzo de modelado de gráficos en Spanner Studio.
2. Agrega un nodo al gráfico y selecciona Fuente de datos existente como su fuente de datos.
3. Asigna una etiqueta al nodo. De forma predeterminada, esta etiqueta coincide con el nombre del nodo, pero se puede cambiar.
4. Define las propiedades asociadas con la etiqueta. Spanner asigna las columnas de la tabla a las propiedades y sus claves primarias a las claves de elemento. Para personalizar esta configuración, haz lo siguiente:
   • Crear propiedades nuevas: Agrega propiedades nuevas, lo que hace que Spanner cree automáticamente las columnas subyacentes en tu tabla.
   • Quitar propiedades: Quita las columnas asignadas que no necesites para este nodo.

Bordes del modelo

Para agregar un borde al gráfico, sigue estos pasos:

Desde cero

Cuando creas un borde nuevo desde cero, se crea automáticamente la tabla subyacente. A medida que defines los nodos de origen y destino, Spanner configura las claves primarias necesarias y las columnas de referencia en segundo plano.

1. Abre el lienzo de modelado de gráficos en Spanner Studio.

2. Agrega un borde al gráfico y selecciona Nuevo como su fuente de datos. Ingresa el nombre del borde.

3. Selecciona los nodos de origen y destino. Spanner genera las propiedades necesarias para identificar las claves de elemento de origen y destino, y las usa como las claves de elemento predeterminadas del borde.

   De forma predeterminada, solo puede existir un borde entre dos nodos específicos porque Spanner usa las claves de elemento de nodo de origen y destino para identificar de forma única cada borde. Si necesitas varios bordes entre los mismos dos nodos (un caso de uso común en el mundo real), define una propiedad adicional y selecciona Es clave de elemento para mantener la unicidad de cada borde.

4. Asigna una etiqueta al borde. De forma predeterminada, coincide con el nombre del borde.

5. Define las propiedades adicionales del borde.

Cuando finalices el borde, Spanner generará automáticamente las instrucciones DDL necesarias para optimizar los recorridos de borde. Para obtener más detalles, consulta Revisa y genera DDL.

Desde una tabla existente

Cuando asignas un borde a una tabla existente, Spanner usa el esquema de la tabla como base. Su etiqueta, propiedades y claves se heredan automáticamente de la tabla, pero puedes anularlas o agregar propiedades nuevas.

1. Abre el lienzo de modelado de gráficos en Spanner Studio.

2. Agrega un borde al gráfico y selecciona Tabla existente como su fuente de datos.

3. Selecciona los nodos de origen y destino. Define las columnas de referencia de origen y destino references columns.

4. Asigna una etiqueta al borde. De forma predeterminada, coincide con el nombre de la tabla de entrada del borde.

5. Define las propiedades asociadas con la etiqueta. Spanner asigna automáticamente las columnas de la tabla a las propiedades y sus claves primarias a las claves de elemento de borde. Puedes modificar esta configuración de las siguientes maneras:

   • Crear propiedades nuevas: Agrega propiedades nuevas, y Spanner creará las columnas subyacentes en tu tabla.
   • Quitar propiedades: Quita las columnas asignadas que no necesites para este borde.

En el caso de los bordes creados a partir de tablas existentes, Spanner no genera instrucciones DDL para optimizar los recorridos de borde. Consulta la práctica recomendada del esquema para aplicar optimizaciones de forma manual.

Modifica un gráfico

Puedes cargar un gráfico de propiedades existente en Spanner Studio para actualizar su estructura.

1. En el explorador de objetos, busca el gráfico que deseas editar y elige Ver/modificar visualmente en el Más opciones menú.
2. Agrega nodos o bordes nuevos desde cero o asignados desde tablas existentes.
3. Actualiza las propiedades de los nodos y bordes existentes. Puedes usar las columnas disponibles de las tablas subyacentes o agregar propiedades nuevas, y las columnas correspondientes se agregarán automáticamente a la tabla subyacente.
4. Quita nodos o bordes de la definición del gráfico.

Revisa y genera DDL

Cuando se complete el modelado, Spanner generará las siguientes instrucciones DDL según tu modelo.

• CREATE OR REPLACE PROPERTY GRAPH: Crea o actualiza la definición del gráfico.
• CREATE TABLE: Crea las tablas subyacentes para los nodos o bordes creados desde cero.
• ALTER TABLE ADD COLUMN: Agrega columnas de propiedades nuevas a los nodos o bordes asignados desde tablas existentes.
• ALTER TABLE ADD CONSTRAINT: Crea restricciones de clave externa para optimizar el recorrido de borde directo.
• CREATE INDEX: crea índices de borde inverso para optimizar el recorrido de borde inverso.

Para confirmar los cambios en el gráfico, sigue estos pasos:

1. Presiona el botón Generar DDL para generar el esquema. Se crean las instrucciones DDL necesarias que se describieron anteriormente.
2. Revisa las instrucciones DDL generadas en el editor de Spanner Studio. Las instrucciones se presentan en el orden correcto para la ejecución y contienen comentarios que explican cada objeto de esquema. Puedes editar cualquier instrucción antes de continuar.
3. Ejecuta las instrucciones para confirmar los cambios en tu base de datos.

Limitaciones

• Solo cambios aditivos: Por seguridad, la herramienta no genera instrucciones DROP TABLE ni DROP COLUMN. Quitar un nodo, un borde o una propiedad solo actualiza la definición de PROPERTY GRAPH. No quita las tablas y columnas subyacentes.
• Algunos objetos de esquema no compatibles: Esta herramienta no genera automáticamente todos los objetos de esquema posibles, los tipos de datos de columna ni sus calificadores. Sin embargo, puedes editar manualmente las instrucciones DDL generadas en el editor antes de confirmarlas.
• No se admite guardar borradores: Cuando modelas un gráfico, el progreso no se guarda si cierras la página.
• No se admiten datos sin esquema: Esta herramienta solo genera gráficos con estructura formal. Si tu caso de uso requiere datos sin esquema, puedes usar este ejemplo de esquema como base para crear tu gráfico de datos sin esquema.
• No se admiten vistas ni tablas de esquema con nombre: No puedes seleccionar vistas de base de datos ni tablas de esquema con nombre como fuente de datos cuando asignas nodos y bordes a fuentes de datos existentes.
• No se admiten restricciones ni índices de bordes asignados: La herramienta no genera restricciones de clave externa ni índices de borde inverso para los bordes asignados desde tablas existentes. Consulta las prácticas recomendadas para la creación manual.

¿Qué sigue?

• Administra datos de Spanner Graph.
• Obtén información sobre las consultas de Spanner Graph.
• Obtén información sobre las prácticas recomendadas para ajustar las consultas de Spanner Graph.