En esta página, se describe cómo enumerar, crear, actualizar, borrar y mostrar los detalles de una configuración de instancia 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) proporcionados.
Muestra configuraciones de instancias
Puedes enumerar todas las configuraciones de instancias de Spanner disponibles con Google Cloud CLI y las bibliotecas cliente. Para encontrar una lista de todas las configuraciones 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.
Ruby
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Cómo mostrar detalles de la configuración de la instancia
Puedes mostrar los detalles de cualquier configuración de instancia con Google Cloud CLI y las bibliotecas cliente. Cuando creas una nueva configuración de instancia personalizada, puedes agregar cualquier ubicación que aparezca en optionalReplicas
como una réplica opcional.
Si no ves la ubicación de la réplica de solo lectura que deseas, puedes
solicitar una nueva región opcional de réplica de solo lectura.
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 la ubicación geográfica de la instancia 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 para la configuración base de 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 la instancia base. Consulta las configuraciones regionales disponibles y las configuraciones multirregionales disponibles para ver las listas de configuraciones de instancias básicas 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 configuración de instancia personalizada.etag
(solo para configuraciones personalizadas) es una representación de la configuración en una cadena codificada en base64. 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.
Ruby
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 regional o de varias regiones personalizada y agregar réplicas de solo lectura opcionales para escalar las operaciones de lectura y admitir lecturas inactivas de baja latencia. Consulta las configuraciones regionales disponibles y las configuraciones multirregionales disponibles para obtener listas de configuraciones de instancias básicas que se pueden usar para crear una configuración de instancias personalizada. No puedes crear una configuración de instancia birregional personalizada. Para obtener más información sobre la replicación y los tipos de réplicas de Spanner, consulta Replicación.
Para crear una configuración de instancia personalizada, debes tener el permiso spanner.instanceConfigs.create
. De forma predeterminada, los roles que tengan el permiso spanner.instances.create
también tendrán el permiso spanner.instanceConfigs.create
.
Console
No puedes crear una configuración de instancia personalizada con la console de Google Cloud. Para crear una instancia con réplicas de solo lectura, usa la CLI de gcloud o las bibliotecas cliente.
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 configuración de instancia base o 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
- Es un identificador permanente que es único en tu proyecto de Google Cloud. No puedes cambiar el ID de configuración de la instancia más adelante. El prefijo
custom-
es obligatorio para evitar conflictos de nombres con las configuraciones de instancias básicas. DISPLAY-NAME
- Es el nombre que se mostrará para la configuración de la instancia personalizada en la consola de Google Cloud. Si eliges usar las marcas `--base-config` y `--replicas`, proporciona los valores siguientes:
BASE-CONFIG
- Es el nombre de la región de la configuración de la instancia base en la que se basa la configuración de tu instancia personalizada. Por ejemplo,
eur6
oregional-us-central1
. LOCATION
- El nombre de la región de los recursos de publicación (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
- Es el tipo de réplica. Para averiguar 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
- TESTIGO
- Los elementos de la lista se separan con “:”.
- A menos que se use la marca
--[clone-config]
, se deben especificar todas las réplicasLOCATION
yTYPE
cuando se crea una configuración de instancia personalizada, incluidas las predefinidas en la configuración base. Para obtener más información, consulta el texto de ayuda de describe de gcloud instance-configs.
Si decides usar las marcas --clone-config
y --add-replicas
(solo usa --skip-replicas
si hay réplicas que quieres omitir para que no se clonen), proporciona los siguientes valores:
--clone-config=INSTANCE-CONFIG
Usa esta marca como una forma conveniente de clonar otra configuración de instancia base o 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 se copian todas las demás ubicaciones de réplica de la configuración de la 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 se copian 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 siguientes marcas y valores son opcionales:
--labels=KEY=VALUE,[...]
KEY
yVALUE
: Es una lista de pares clave-valor para agregar a la configuración de tu instancia 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 se realizará correctamente antes de ejecutarla.
Por ejemplo, para crear una configuración de instancia personalizada con la configuración base de eur6
con una réplica de solo lectura adicional en us-east1
, ejecuta lo siguiente:
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.
Ruby
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 instancia personalizada
Puedes crear una instancia en una configuración de instancia personalizada.
Console
Para crear una instancia en una configuración de instancia personalizada, usa la CLI de gcloud o las bibliotecas cliente.
gcloud
Después de crear la configuración de la instancia personalizada, sigue las instrucciones que se proporcionan en Cómo crear una instancia.
C++
Después de crear la configuración de la instancia personalizada, sigue las instrucciones que se proporcionan en Cómo crear una instancia.
C#
Después de crear la configuración de la instancia personalizada, sigue las instrucciones que se proporcionan en Cómo crear una instancia.
Go
Después de crear la configuración de la instancia personalizada, sigue las instrucciones que se proporcionan en Cómo crear una instancia.
Java
Después de crear la configuración de la instancia personalizada, sigue las instrucciones que se proporcionan en Cómo crear una instancia.
Node.js
Después de crear la configuración de la instancia personalizada, sigue las instrucciones que se proporcionan en Cómo crear una instancia.
PHP
Después de crear la configuración de la instancia personalizada, sigue las instrucciones que se proporcionan en Cómo crear una instancia.
Python
Después de crear la configuración de la instancia personalizada, sigue las instrucciones que se proporcionan en Cómo crear una instancia.
Ruby
Después de crear la configuración de la instancia personalizada, sigue las instrucciones que se proporcionan en Cómo crear 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 la configuración de tu instancia 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 elijas. 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, mueve tu instancia a esta nueva configuración de instancia personalizada.
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 la configuración de tu instancia personalizada.
Comenzará con
custom-
. NEW-DISPLAY-NAME
- Es el nombre nuevo que se mostrará para la configuración de la instancia en la consola de Google Cloud.
KEY
yVALUE
- Es 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 deben contener solo guiones (-), guiones bajos (_), caracteres en minúscula y números.
Las siguientes marcas y valores son opcionales:
--etag=ETAG
: El argumentoETAG
se puede usar 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 se realizará correctamente 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.
Ruby
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Cómo borrar la configuración de una instancia personalizada
Para borrar una configuración de instancia personalizada, primero borra cualquier instancia en la configuración de la instancia.
gcloud
Usa el comando gcloud spanner instance-configs delete
y reemplaza CUSTOM-INSTANCE-CONFIG-ID
por el ID de configuración de la instancia personalizada:
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.
Ruby
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
¿Qué sigue?
- Obtén más información sobre cómo insertar, actualizar y borrar datos con el lenguaje de manipulación de datos (DML) o gcloud CLI.
- Otorga funciones de IAM para la instancia y sus bases de datos.
- Obtén información para diseñar un esquema de Spanner.
- Cuotas y límites de Spanner.