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 proporcionados 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 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 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 eur6
, ejecuta lo siguiente:
gcloud spanner instance-configs describe eur6
Este es un resultado de ejemplo para la configuración básica 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 obtener listas de configuraciones de instancias base que se pueden usar para crear una configuración de instancia personalizada.configType
indica si la configuración de esta 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 cadena de la configuración 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.
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 las configuraciones regionales disponibles y las configuraciones multirregionales disponibles para obtener listas de configuraciones de instancias base que se pueden usar para crear una configuración de instancia personalizada. Para obtener más información sobre los tipos de replicación y 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, los roles 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 configuración base o de instancia personalizada, a la vez que declaras 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 instancias más adelante. Se requiere el prefijo
custom-
para evitar conflictos de nombres con la configuración de instancias base. DISPLAY-NAME
- 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 siguientes valores:
BASE-CONFIG
- 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
- 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
- TESTIMONIO
- Los elementos de la lista están separados por ":".
- A menos que se use la marca
--[clone-config]
, se deben especificar todas las réplicasLOCATION
yTYPE
cuando se cree la configuración de instancias personalizadas, incluidas las predefinidas en la configuración base. Para obtener más información, consulta la 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 deseas omitir para la clonación), 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 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 deseas 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 la instancia baseeur6
, ejecuta el siguiente comando: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 evitar que se clone 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 el siguiente comando: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
: Una lista de pares de clave y valor para agregar a la configuración de tu instancia personalizadaLas 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 (_), minúsculas 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 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.
Rita
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Crea una instancia con una configuración de instancia personalizada
Puedes crear una instancia con una configuración de instancia personalizada.
Console
Para crear una instancia con una configuración personalizada, sigue las instrucciones que se proporcionan 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 instancia personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
C++
Después de crear la configuración de instancia personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
C#
Después de crear la configuración de instancia personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Go
Después de crear la configuración de instancia personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Java
Después de crear la configuración de instancia personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Node.js
Después de crear la configuración de instancia personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
PHP
Después de crear la configuración de instancia personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Python
Después de crear la configuración de instancia personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Rita
Después de crear la configuración de instancia personalizada, sigue las instrucciones que se proporcionan en Crea una instancia.
Actualiza la configuración de una 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.
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
- Una lista de pares clave-valor que se deben actualizar.
- Las claves deben comenzar con un carácter en minúscula y contener solo guiones (-), guiones bajos (_), minúsculas y números. Los valores deben contener solo guiones (-), guiones bajos (_), minúsculas y números.
Las siguientes marcas y valores 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 se realice de forma correcta 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 la configuración de una instancia personalizada
Para borrar la configuración de una 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 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.
Rita
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
¿Qué sigue?
- Aprende a 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