En esta página, se describe cómo enumerar, crear, actualizar, borrar y mostrar los detalles de una configuración de instancias de Spanner. Algunas funciones de configuración de instancias personalizadas no están disponibles en la IU de la consola de Google Cloud. En esos casos, usa los comandos de Google Cloud CLI (gcloud).
Muestra configuraciones de instancias
Puedes enumerar todas las opciones de configuración de instancias de Spanner disponibles con Google Cloud CLI y las bibliotecas cliente. Para encontrar una lista de todas las opciones de configuración de instancias de Spanner, consulta Configuraciones regionales y multirregionales.
gcloud
Ejecuta el comando gcloud spanner instance-configs list
:
gcloud spanner instance-configs list
C++
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
C#
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Rita
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Mostrar detalles de configuración de instancias
Puedes mostrar los detalles de cualquier configuración de instancias con Google Cloud CLI y las bibliotecas cliente. Cuando creas una configuración de instancia personalizada nueva, puedes agregar cualquier ubicación que aparezca en optionalReplicas
como una réplica opcional.
Si no ves la ubicación de réplica de solo lectura que deseas, puedes solicitar una nueva región de réplica de solo lectura opcional.
Para obtener más información, consulta Crea una configuración de instancia personalizada.
gcloud
Ejecuta el comando gcloud spanner instance-configs describe
:
gcloud spanner instance-configs describe INSTANCE-CONFIG
Ingresa el siguiente valor:
INSTANCE-CONFIG
- La configuración de la instancia, que define su ubicación geográfica y afecta la forma en que se replican los datos. Por ejemplo,
eur6
ous-central1
.
Para mostrar los detalles de la configuración base de eur6
, ejecuta lo siguiente:
gcloud spanner instance-configs describe eur6
Este es un resultado de ejemplo de la configuración base eur6
:
configType: GOOGLE_MANAGED
displayName: Europe (Netherlands, Frankfurt)
freeInstanceAvailability: UNSUPPORTED
leaderOptions:
- europe-west3
- europe-west4
name: projects/cloud-spanner-demo/instanceConfigs/eur6
optionalReplicas:
- displayName: South Carolina
labels:
cloud.googleapis.com/country: US
cloud.googleapis.com/location: us-east1
cloud.googleapis.com/region: us-east1
location: us-east1
type: READ_ONLY
- displayName: South Carolina
labels:
cloud.googleapis.com/country: US
cloud.googleapis.com/location: us-east1
cloud.googleapis.com/region: us-east1
location: us-east1
type: READ_ONLY
replicas:
- defaultLeaderLocation: true
location: europe-west4
type: READ_WRITE
- location: europe-west4
type: READ_WRITE
- location: europe-west3
type: READ_WRITE
- location: europe-west3
type: READ_WRITE
- location: europe-west6
type: WITNESS
Notas de uso adicionales:
baseConfig
(solo para configuraciones personalizadas) apunta a la configuración de instancia base. Consulta los parámetros de configuración regionales disponibles y los parámetros de configuración multirregionales disponibles para obtener listas de los parámetros de configuración de instancias base que se pueden usar para crear una configuración de instancia personalizada.configType
indica si esta configuración de instancia es una configuración de instancia base o una personalizada.etag
(solo para configuraciones personalizadas) es una representación de cadena codificada en base64 de la configuración. Se usa para el control de simultaneidad optimista.
C++
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
C#
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Rita
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Crea una configuración de instancia personalizada
Puedes crear una configuración de instancia personalizada y agregar réplicas de solo lectura opcionales para escalar lecturas y admitir lecturas inactivas de baja latencia. Consulta los parámetros de configuración regionales disponibles y los parámetros de configuración multirregionales disponibles para obtener listas de los parámetros de configuración de instancias base que se pueden usar para crear una configuración de instancias personalizada. Para obtener más información sobre la replicación y los tipos de réplica de Spanner, consulta Replicación.
Para crear una configuración de instancia personalizada, debes tener el permiso spanner.instanceConfigs.create
. De forma predeterminada, las funciones que tienen el permiso spanner.instances.create
también tendrán el permiso spanner.instanceConfigs.create
.
Console
No puedes crear una configuración de instancia personalizada independiente con la consola de Google Cloud. Para crear una instancia con réplicas de solo lectura, consulta las instrucciones proporcionadas en Crea una instancia con la configuración de instancia personalizada.
Puedes usar Google Cloud CLI y las bibliotecas cliente para crear una configuración de instancia personalizada independiente.
gcloud
Usa el comando gcloud spanner instance-configs create
:
gcloud spanner instance-configs create CUSTOM-INSTANCE-CONFIG-ID \
--display-name=DISPLAY-NAME \
--base-config=BASE-CONFIG \
--labels=KEY=VALUE,[...] \
--replicas=location=LOCATION, type=TYPE[:...]
Puedes usar la marca --clone-config
como una forma conveniente de clonar otra base o una configuración de instancia personalizada y, al mismo tiempo, declarar la ubicación y el tipo de una réplica personalizada específica.
gcloud spanner instance-configs create CUSTOM-INSTANCE-CONFIG-ID \
--display-name=DISPLAY-NAME \
--clone-config=INSTANCE-CONFIG \
--labels=KEY=VALUE,[...] \
--add-replicas=location=LOCATION, type=TYPE[:...] \
--skip-replicas=location=LOCATION, type=TYPE[:...]
Ingresa los siguientes valores:
CUSTOM-INSTANCE-CONFIG-ID
- Un identificador permanente que es único dentro de tu proyecto de Google Cloud. No podrás cambiar el ID de configuración de la instancia más adelante. Se requiere el prefijo
custom-
para evitar conflictos de nombres con las configuraciones de instancia de base. DISPLAY-NAME
- Es el nombre que se mostrará para la configuración de instancias personalizadas en la consola de Google Cloud. Si eliges usar las marcas “--base-config” y “--replicas”, proporciona los siguientes valores:
BASE-CONFIG
- Es el nombre de la región de la configuración de instancia base en la que se basa la configuración de tu instancia personalizada. Por ejemplo,
eur6
oregional-us-central1
. LOCATION
- Es el nombre de la región de los recursos de entrega (réplicas); por ejemplo,
us-east1
. Para saber qué nombres de ubicación se aceptan, ejecutagcloud spanner instance-configs describe INSTANCE-CONFIG
y consulta las listasreplicas
yoptionalReplicas
. TYPE
- El tipo de réplica. Para saber qué ubicaciones y tipos de réplicas correspondientes se aceptan, ejecuta
gcloud spanner instance-configs describe INSTANCE-CONFIG
y consulta las listasreplicas
yoptionalReplicas
. Los tipos son uno de los siguientes:- READ_ONLY
- READ_WRITE
- TESTIMONIO
- Los elementos de la lista están separados por ":".
- A menos que se use la marca
--[clone-config]
, todas las réplicasLOCATION
yTYPE
deben especificarse cuando se crea una configuración de instancia personalizada, incluidas las predefinidas en la configuración base. Para obtener más información, consulta gcloud instance-configs describe help-text.
Si eliges usar las marcas --clone-config
y --add-replicas
(solo usa --skip-replicas
si hay réplicas que no deseas que se clonen), proporciona los siguientes valores:
--clone-config=INSTANCE-CONFIG
Usa esta marca como una forma conveniente de clonar otra base o configuración de instancia personalizada y, al mismo tiempo, declarar la ubicación y el tipo de una réplica personalizada específica. Luego, usa
--add-replicas=location=LOCATION,type=TYPE
para especificar dónde quieres agregar tu réplica opcional.Por ejemplo, para crear una configuración de instancia personalizada con dos réplicas de solo lectura en
us-east1
mientras copias todas las demás ubicaciones de réplica de la configuración de instancia baseeur6
, ejecuta lo siguiente:gcloud spanner instance-configs create custom-eur6 --clone-config=eur6 \ --add-replicas=location=us-east1,type=READ_ONLY:location=us-east1,type=READ_ONLY
--skip-replicas=location=LOCATION,type=TYPE
Usa esta marca para omitir la clonación de cualquier réplica.
Por ejemplo, para crear una configuración de instancia personalizada con una réplica de solo lectura en
us-east4
mientras copias todas las demás ubicaciones de réplica de la configuración de la instancia basenam3
, excepto la réplica de solo lectura enus-central1
, ejecuta lo siguiente:gcloud spanner instance-configs create custom-nam3 --clone-config=nam3 \ --add-replicas=location=us-east4,type=READ_ONLY \ --skip-replicas=location=us-central1,type=READ_ONLY
Las marcas y los valores siguientes son opcionales:
--labels=KEY=VALUE,[...]
KEY
yVALUE
: Una lista de pares de clave y valor para agregar a la configuración de instancias personalizada.Las claves deben comenzar con un carácter en minúscula y contener solo guiones (-), guiones bajos (_), caracteres en minúscula y números. Los valores deben contener solo guiones (-), guiones bajos (_), caracteres en minúscula y números.
--validate-only
Usa esta marca para validar que la solicitud tendrá éxito antes de ejecutarla.
Por ejemplo, para crear una configuración de instancia personalizada con la configuración base eur6
con una réplica adicional de solo lectura en us-east1
, ejecuta el siguiente comando:
gcloud spanner instance-configs create custom-eur6 \
--display-name="Custom eur6" --clone-config=eur6 \
--add-replicas=location=us-east1,type=READ_ONLY \
También puedes crear una configuración de instancia personalizada sin la marca --clone-config
:
gcloud spanner instance-configs create custom-eur6 \
--display-name="Custom eur6" --base-config=eur6 \
--replicas=location=europe-west4,type=READ_WRITE:location=europe-west3,type=READ_WRITE:location=europe-west4,type=READ_WRITE:location=europe-west3,type=READ_WRITE:location=europe-west6,type=WITNESS:location=us-east1,type=READ_ONLY
Deberías ver el siguiente resultado:
Creating instance-config...done.
C++
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
C#
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Rita
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Crea una instancia en una configuración de instancias personalizada
Puedes crear una instancia en una configuración de instancias personalizada.
Console
Para crear una instancia en una configuración de instancia personalizada, sigue las instrucciones que se brindan en Crea una instancia.
Ten en cuenta que no necesitas crear una configuración de instancia personalizada independiente en la consola de Google Cloud. La configuración de la instancia se crea automáticamente cuando la creas.
gcloud
Después de crear la configuración de instancias personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
C++
Después de crear la configuración de instancias personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
C#
Después de crear la configuración de instancias personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Go
Después de crear la configuración de instancias personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Java
Después de crear la configuración de instancias personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Node.js
Después de crear la configuración de instancias personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
PHP
Después de crear la configuración de instancias personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Python
Después de crear la configuración de instancias personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Rita
Después de crear la configuración de instancias personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Actualiza una configuración de instancia personalizada
Puedes cambiar el nombre visible y las etiquetas de una configuración de instancia personalizada.
No puedes cambiar ni actualizar las réplicas de tu configuración de instancias personalizada.
Sin embargo, puedes crear una nueva configuración de instancia personalizada con réplicas adicionales y, luego, mover tu instancia a la nueva configuración de instancia personalizada con las réplicas adicionales que elegiste. Por ejemplo, si tu instancia está en us-central1
y quieres agregar una réplica de solo lectura us-west1
, debes crear una nueva configuración de instancia personalizada con us-central1
como la configuración base y agregar us-west1
como una réplica de solo lectura. Luego, traslada tu instancia a esta configuración de instancia personalizada nueva.
gcloud
Usa el comando gcloud spanner instance-configs update
:
gcloud spanner instance-configs update CUSTOM-INSTANCE-CONFIG-ID \
--display-name=NEW-DISPLAY-NAME \
--update-labels=KEY=VALUE,[...], \
--etag=ETAG
Ingresa los siguientes valores:
CUSTOM-INSTANCE-CONFIG-ID
- Un identificador permanente de tu configuración de instancias personalizada.
Comenzará con
custom-
. NEW-DISPLAY-NAME
- El nombre nuevo que se mostrará para la configuración de la instancia en la consola de Google Cloud.
KEY
yVALUE
- Una lista de pares clave-valor para actualizar.
- Las claves deben comenzar con un carácter en minúscula y contener solo guiones (-), guiones bajos (_), caracteres en minúscula y números. Los valores solo deben contener guiones (-), guiones bajos (_), caracteres en minúscula y números.
Las marcas y los valores siguientes son opcionales:
--etag=ETAG
: Se puede usar el argumentoETAG
para seleccionar y omitir actualizaciones simultáneas en una situación de lectura, modificación y escritura.--validate-only
: Usa esta marca para validar que la solicitud tendrá éxito antes de ejecutarla.
Por ejemplo:
gcloud spanner instance-configs update custom-eur6 \
--display-name="Customer managed europe replicas"
C++
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
C#
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Rita
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Borrar una configuración de instancia personalizada
Para borrar una configuración de instancia personalizada, primero borra cualquier instancia en la configuración de instancias.
gcloud
Usa el comando gcloud spanner instance-configs delete
y reemplaza CUSTOM-INSTANCE-CONFIG-ID
por el ID de configuración de instancia personalizado:
gcloud spanner instance-configs delete CUSTOM-INSTANCE-CONFIG-ID
C++
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
C#
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Rita
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
¿Qué sigue?
- Obtén información para insertar, actualizar y borrar datos con el lenguaje de manipulación de datos (DML) o la CLI de gcloud.
- Otorga funciones de IAM para la instancia y sus bases de datos.
- Aprende a diseñar un esquema de Spanner.
- Cuotas y límites de Spanner