Configura una instancia de Spanner

Spanner es un servicio de base de datos esencial y completamente administrado que combina datos relacionales, de gráficos, de pares clave-valor y de búsqueda. Spanner ofrece coherencia transaccional a escala global, replicación síncrona automática para alta disponibilidad y compatibilidad con los siguientes dialectos de SQL:

  • GoogleSQL
  • PostgreSQL

Para obtener más información, consulta Descripción general de las instancias.

En este documento, se describen las conexiones y los parámetros que puedes configurar cuando usas el Centro de diseño de apps para crear una instancia de Spanner. Los parámetros de configuración se basan en el módulo de Terraform terraform-google-cloud-spanner.

Conexiones de componentes

En la siguiente tabla, se incluyen los componentes que puedes conectar a una instancia de Spanner y las actualizaciones resultantes en tu aplicación y su código de Terraform generado.

Componente conectado

Actualizaciones de la aplicación

Información general

Plantilla de instancia de Compute Engine

  • Las instancias de Compute Engine pueden leer y escribir datos en la instancia de Spanner.
  • Se agrega la función roles/spanner.databaseAdmin a la cuenta de servicio de la plantilla de instancia de Compute Engine.
  • La cuenta de servicio de Compute Engine se agrega como un usuario de IAM a la instancia de Spanner.
Usa Spanner en una instancia de máquina virtual

Cuenta de servicio

  • La cuenta de servicio tiene acceso a la instancia de Spanner.
  • La cuenta de servicio se agrega como un usuario de IAM a la instancia de Spanner.
Configura una instancia con una cuenta de servicio

Cloud Run

  • El servicio de Cloud Run puede administrar la instancia de Spanner.
  • Los detalles de la conexión de Spanner se agregan a las variables de entorno de Cloud Run.
  • Se agrega la función roles/spanner.databaseAdmin a la cuenta de servicio de Cloud Run.
  • La información de IAM de la cuenta de servicio de Cloud Run se agrega a la instancia de Spanner.
Conéctate a los Google Cloud servicios

Parámetros de configuración obligatorios

Si tu plantilla contiene un componente de Spanner, debes configurar los siguientes parámetros antes de la implementación.

Nombre del parámetro

Descripción y restricciones

Información general

ID del proyecto

El proyecto en el que deseas implementar la instancia de Spanner.

Configura componentes

Nombre de la instancia

Un identificador único para la instancia, que no se puede cambiar después de crearla. El nombre debe tener entre 6 y 30 caracteres. name

Configuración de la instancia

config Configuraciones de instancias

Parámetros de configuración opcionales

Los siguientes parámetros son opcionales. Para mostrar los parámetros avanzados, en el área Configuración, selecciona Mostrar campos avanzados.

Función

Nombre del parámetro

Información de descripción y restricción

Información general

Tamaño de la instancia

Cantidad de nodos

nodeCount Capacidad de procesamiento, nodos y unidades de procesamiento

Unidades de procesamiento

processingUnits Capacidad de procesamiento, nodos y unidades de procesamiento

Nombre visible de la instancia

displayName Cambia el nombre visible

Crear instancia

De forma predeterminada, se crea una instancia nueva de Spanner. Desmarca la casilla de verificación si deseas evitar crear una instancia nueva y usar una existente en su lugar. Crea y administra instancias

Habilitar ajuste de escala automático

Selecciona esta opción para habilitar el ajuste de escala automático en la instancia de Spanner. Descripción general del ajuste de escala automático

IAM de la instancia

Una lista separada por comas de los permisos en la instancia. Por ejemplo, user:user1@cymbalgroup.com=>roles/spanner.databaseAdmin, user:user2@cymbalgroup.com=>roles/spanner.databaseAdmin Descripción general de IAM
Etiquetas de instancia

Clave

etiquetas correspondientes. Etiqueta una instancia

Valor

etiquetas correspondientes. Etiqueta una instancia
Configuración de la base de datos

Clave

La clave del objeto de mapa database_config. database_config

Período de retención de la versión

versionRetentionPeriod Descripción general de la recuperación de un momento determinado (PITR)

DDL

ddl GoogleSQL o PostgreSQL

Nombre de la clave de KMS

kmsKeyName Descripción general de las claves de encriptación administradas por el cliente (CMEK)

Protección contra la eliminación

Selecciona esta opción para evitar que Terraform borre la base de datos. deletion_protection

IAM de la base de datos

Una lista separada por comas de los permisos en la base de datos. Por ejemplo, user:user1@cymbalgroup.com=>roles/spanner.databaseAdmin, user:user2@cymbalgroup.com=>roles/spanner.databaseAdmin Descripción general de IAM

Habilitar copia de seguridad

De forma predeterminada, se crea una copia de seguridad automática de la base de datos. Si no deseas una copia de seguridad, desmarca la casilla de verificación. Descripción general de las copias de seguridad

Retención de copias de seguridad

retentionDuration Copias de seguridad incrementales

Crear base de datos

De forma predeterminada, se crea una base de datos. Si no deseas una base de datos, desmarca la casilla de verificación. Descripción general de las bases de datos

Texto de especificación de Cron

texto Crea y administra programas de copias de seguridad

Unidades de procesamiento mínimas

minProcessingUnits Escalador automático administrado

Unidades de procesamiento máximas

maxProcessingUnits Escalador automático administrado

Nodos mínimos

minNodes Escalador automático administrado

Nodos máximos

maxNodes Escalador automático administrado

Porcentaje de uso de CPU de alta prioridad

highPriorityCpuUtilizationPercent Escalador automático administrado

Porcentaje de uso de almacenamiento

storageUtilizationPercent Escalador automático administrado

Ubicación de la réplica

ubicación Escalado automático asimétrico de solo lectura

Anular nodos mínimos

AutoscalingConfigOverrides Parámetros del escalador automático administrado

Anular nodos máximos

AutoscalingConfigOverrides Parámetros del escalador automático administrado

Edición

Edición Descripción general de las ediciones de Spanner

Tipo de programación predeterminada de copias de seguridad

defaultBackupScheduleType Programaciones predeterminadas de copias de seguridad

Forzar destrucción

Selecciona esta opción para borrar las copias de seguridad cuando borres la instancia de Spanner. force_destroy

Usar especificación de copia de seguridad completa

fullBackupSpec Programaciones de copias de seguridad

Usar especificación de copia de seguridad incremental

incrementalBackupSpec Copias de seguridad incrementales