Esta página describe cómo enumerar, crear, actualizar, eliminar y mostrar los detalles de una configuración de instancia de Spanner. Algunas funcionalidades de configuración de instancias personalizadas no están disponibles en el 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 todos los parámetros de configuración de instancias de Spanner disponibles con Google Cloud CLI y las bibliotecas cliente. Para encontrar una lista de todos los parámetros 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.
Ruby
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 el
Google Cloud CLI y las bibliotecas cliente. Cuando
crear 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
solicita una nueva región de réplica opcional 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
en 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 ejemplo de resultado 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 base la configuración de una instancia de Compute Engine. Consulta los parámetros de configuración regionales disponibles. y los parámetros de configuración multirregionales disponibles para listas de parámetros de configuración de instancias de base que pueden usarse para crear un la configuración de instancias personalizadas.configType
indica si la configuración de esta instancia es una una configuración de instancia base o una configuración de instancia personalizada.etag
(solo para configuraciones personalizadas) es una string codificada en base64. una representación visual de la configuración. Se usa para la simultaneidad optimista control.
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 personalizada, regional o multirregional y agregar réplicas de solo lectura opcionales para escalar y admiten lecturas inactivas de baja latencia. Consulta parámetros de configuración regionales disponibles y los parámetros de configuración multirregionales disponibles para listas de configuraciones de instancias de base que pueden usarse para crear un la configuración de una instancia de Compute Engine. No puedes crear un perfil personalizado configuración de instancias en una región doble. Obtén más información sobre Spanner tipos de réplicas y replicación, consulta Replicación.
Para crear una configuración de instancia personalizada, debes tener la
spanner.instanceConfigs.create
. De forma predeterminada, los roles que tienen
El permiso spanner.instances.create
también tendrá la
spanner.instanceConfigs.create
.
Console
No puedes crear una configuración de instancia personalizada independiente con la console de Google Cloud. Para crear una instancia con réplicas de solo lectura, consulta a las instrucciones proporcionadas en Crea una instancia con la configuración de instancias personalizada.
Puedes usar Google Cloud CLI y el cliente bibliotecas 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 otro.
la configuración de instancia básica o personalizada y, al mismo tiempo, declarar la ubicación y
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
- A
es un identificador permanente que es único en tu proyecto de Google Cloud. Tú
no puedes cambiar el ID de configuración de la instancia más adelante. El
custom-
se requiere el prefijo para evitar conflictos de nombres con la instancia base parámetros de configuración. DISPLAY-NAME
- El nombre que se mostrará para la configuración de instancia personalizada en el Consola de Google Cloud Si eliges usar las marcas “--base-config” y “--replicas”, proporciona la los siguientes valores:
BASE-CONFIG
- Es el nombre de la región de la configuración de instancia base en la que se
la configuración de instancias personalizadas. Por ejemplo,
eur6
oregional-us-central1
. LOCATION
- El nombre de la región de los recursos de entrega (réplicas); por ejemplo,
us-east1
Para saber qué nombres de ubicaciones se aceptan, ejecutagcloud spanner instance-configs describe INSTANCE-CONFIG
y consultareplicas
yoptionalReplicas
listas. TYPE
- El tipo de réplica. Para averiguar qué ubicaciones y
tipos de réplicas, ejecuta
gcloud spanner instance-configs describe INSTANCE-CONFIG
y consulta la 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
cuando se crea una configuración de instancias 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,
clona), proporciona los siguientes valores:
--clone-config=INSTANCE-CONFIG
Usa esta marca como una forma conveniente de clonar otra base o personalizar la configuración de instancias y, al mismo tiempo, declarar la ubicación y el tipo de una réplica personalizada específica. Luego, utiliza
--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 otras réplicas de la configuración de la instancia basenam3
, excepto a 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 clave-valor para agregar a tu configuración de instancias personalizada.Las claves deben comenzar con una letra 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 ejecutarse que la modifica.
Por ejemplo, para crear una configuración de instancia personalizada con la 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.
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 instancias personalizada
Puedes crear una instancia en una configuración de instancias personalizada.
Console
Para crear una instancia en una configuración de instancias personalizada, sigue las las instrucciones que se indican en Crea una instancia.
Ten en cuenta que no necesitas crear una instancia personalizada independiente configuración en la consola de Google Cloud. La configuración de la instancia es que se crea automáticamente cuando se crea la instancia.
gcloud
Después de crear la configuración de instancias personalizada, Sigue las instrucciones que se indican en Crea una instancia.
C++
Después de crear la configuración de instancias personalizada, Sigue las instrucciones que se indican en Crea 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 instancias personalizada, Sigue las instrucciones que se indican en Crea 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 instancias personalizada, Sigue las instrucciones que se indican en Crea una instancia.
PHP
Después de crear la configuración de instancias personalizada, Sigue las instrucciones que se indican en Crea una instancia.
Python
Después de crear la configuración de instancias personalizada, Sigue las instrucciones que se indican en Crea una instancia.
Ruby
Después de crear la configuración de instancias personalizada, Sigue las instrucciones que se indican 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
y, luego, trasladar la instancia a la nueva
de instancias personalizada con las réplicas adicionales elegidas. 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 us-west1
como configuración de solo lectura
de Cloud SQL. 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 deben contener solo guiones (-), guiones bajos (_), caracteres en minúscula y y números de serie.
Las marcas y los valores siguientes son opcionales:
--etag=ETAG
:ETAG
se puede usar para seleccionar y omitir actualizaciones simultáneas en un una situación de lectura, modificación y escritura.--validate-only
: Usa esta marca para validar que la solicitud se realice correctamente. antes de ejecutarlo.
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.
Borrar una configuración de instancia personalizada
Para borrar una configuración de instancia personalizada, primero borra cualquier instancia de la la configuración de una instancia de Compute Engine.
gcloud
Usa el comando gcloud spanner instance-configs delete
y reemplaza
CUSTOM-INSTANCE-CONFIG-ID
por la instancia personalizada
ID de configuración:
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?
- Aprende a insertar, actualizar y borrar datos con el lenguaje de manipulación de datos (DML) o la CLI de gcloud.
- Otorga roles 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