En esta página, se describe cómo crear, enumerar, editar y borrar Spanner instancias.
Crea una instancia
Puedes crear una instancia con la consola de Google Cloud, Google Cloud CLI o bibliotecas cliente. También puedes crear con una configuración de instancias personalizada agregando réplicas de solo lectura opcionales.
Console
Ve a la página Crear instancia en la consola de Google Cloud.
Ingresa un Nombre de instancia para mostrar en la consola de Google Cloud. El nombre de la instancia debe ser único en tu proyecto de Google Cloud.
Ingresa un ID de instancia para identificar tu instancia de forma permanente. El El ID de la instancia también debe ser único dentro de tu proyecto de Google Cloud. No puedes cambiar el ID de la instancia más tarde.
Haga clic en Continuar.
En la sección Configura tu instancia, en Elige una configuración, selecciona Regional, Birregional o Multirregión. Como alternativa, si quieres comparar entre las tres configuraciones y, luego, haz clic Compara los parámetros de configuración de las regiones.
Selecciona una configuración del menú desplegable.
Opcional: Para agregar una réplica de solo lectura a una base de Spanner configuración, primero crea una configuración de instancia personalizada con el Google Cloud CLI
Haga clic en Continuar.
En la sección Asignar capacidad de procesamiento, en Seleccionar unidad, haz lo siguiente: haz clic en una de las siguientes opciones:
- Unidades de procesamiento para instancias pequeñas.
- Nodos para instancias grandes. Un nodo consta de 1,000 unidades de procesamiento.
Para obtener más información, consulta Capacidad de procesamiento, nodos y unidades de procesamiento.
En Elegir un modo de escalamiento, haz clic en una de las siguientes opciones:
Asignación manual si quieres configurar la capacidad de procesamiento de forma manual para los recursos de procesamiento y costos fijos.
- La cantidad indica la cantidad de unidades de procesamiento o nodos. para usar en esta instancia.
Ajuste de escala automático (vista previa), para permitir que Spanner agregue y quite automáticamente recursos la capacidad de procesamiento. Para obtener más información sobre el escalador automático administrado ver Escalador automático administrado para Spanner. Configura las siguientes opciones de escalador automático administrado:
- Minimum indica el límite mínimo para reducir la escala verticalmente. según la unidad de medida que elijas para Compute. capacidad. Para obtener más información, consulta Determina el límite mínimo.
- Máximo indica el límite máximo para escalar verticalmente. según la unidad de medida que elijas para Compute. capacidad. Para obtener más información, consulta Determina el límite máximo.
- El objetivo de uso de CPU de alta prioridad indica y el porcentaje de CPU de alta prioridad que se usará. Para obtener más información, consulta Determina el objetivo de uso de CPU.
- El objetivo de uso de almacenamiento indica el porcentaje objetivo. de almacenamiento para usar. Para obtener más información, consulta Determina el objetivo de uso de almacenamiento.
Haz clic en Crear para crear la instancia.
gcloud
Usa la gcloud spanner instances create
.
para crear una instancia. Especifica la capacidad de procesamiento.
o unidades de procesamiento
que quieres en la instancia.
gcloud spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --nodes=NODE-COUNT
o
gcloud spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --processing-units=PROCESSING-UNIT-COUNT
Reemplaza lo siguiente:
- INSTANCE-ID: Es un identificador permanente que es único dentro de tu proyecto de Google Cloud. No puedes cambiar el ID de la instancia más tarde.
- INSTANCE-CONFIG: Es un identificador permanente de tu instancia.
actual, que define la ubicación geográfica de la instancia y
afecta cómo se replican los datos. Para las configuraciones de instancias personalizadas,
comienza con
custom-
. Para obtener más información, consulta instancias parámetros de configuración. - INSTANCE-DESCRIPTION: Es el nombre que se mostrará para la instancia en el Consola de Google Cloud El nombre de la instancia debe ser único en tu proyecto de Google Cloud.
NODE-COUNT: La capacidad de procesamiento de la instancia, expresada como un número de nodos. Cada nodo equivale a 1,000 unidades de procesamiento.
PROCESSING-UNIT-COUNT: La capacidad de procesamiento de la instancia. expresada como un número de unidades de procesamiento. Ingresa cantidades de hasta 1,000 en múltiplos de 100 (100, 200, 300, etc.) e ingresa mayor cantidades en múltiplos de 1000 (1000, 2000, 3000, etc.). Nota: No uses este parámetro si creas una instancia en la que deseas habilitar con el escalador automático administrado más adelante.
Agrega el ajuste de escala automático administrado (vista previa)
También puedes configurar instancias nuevas para usar el ajuste de escala automático administrado con el
gcloud beta spanner instances create
kubectl. Para obtener más información, consulta
Escalador automático administrado para Spanner.
Usa el siguiente comando para crear una instancia con un escalador automático administrado.
gcloud beta spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \ --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
o
gcloud beta spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --autoscaling-min-nodes=MINIMUM_NODES \ --autoscaling-max-nodes=MAXIMUM_NODES \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
Reemplaza lo siguiente:
- INSTANCE-ID: un identificador permanente que es único en tu proyecto de Google Cloud. No puedes cambiar el ID de la instancia más tarde.
- INSTANCE-CONFIG: Es un identificador permanente de tu instancia.
actual, que define la ubicación geográfica de la instancia y
afecta cómo se replican los datos. Para las configuraciones de instancias personalizadas,
comienza con
custom-
. Para obtener más información, consulta instancias parámetros de configuración. - INSTANCE-DESCRIPTION: Es el nombre que se mostrará para la instancia en el Consola de Google Cloud El nombre de la instancia debe ser único en tu proyecto de Google Cloud.
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: el la cantidad mínima de nodos o unidades de procesamiento cuando se reduce la escala. Para ver más consulta Determinar el límite mínimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: el la cantidad máxima de nodos o unidades de procesamiento cuando se escala verticalmente. Para ver más información, consulta Determina el límite máximo.
- CPU_PERCENTAGE: Es el porcentaje objetivo de la CPU de alta prioridad a usan, del 10 al 90%. Si optimizas el costo, usa un valor mayor porcentaje. Para obtener más información, consulta Determina el objetivo de uso de CPU.
- STORAGE_PERCENTAGE: El porcentaje objetivo de almacenamiento que se usará. de 10 a 99%. Para obtener más información, consulta Determina el objetivo de uso de almacenamiento.
Ejemplos para usar configuraciones personalizadas
Para crear una instancia test-instance
en la instancia regional base, sigue estos pasos:
configuración us-central1
, ejecuta lo siguiente:
gcloud spanner instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Para crear una instancia custom-eur6-instance
en la multirregión personalizada, sigue estos pasos:
configuración de instancia custom-eur6
, primero
crear una configuración de instancias personalizada.
Luego, ejecuta lo siguiente:
gcloud spanner instances create custom-eur6-instance --config=custom-eur6 \
--description="Instance with custom read-only" --nodes=1
Deberías ver un mensaje similar al siguiente ejemplo después de la ejecución uno de los comandos anteriores:
Creating instance...done.
C++
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
C#
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Crear una instancia con ajuste de escala automático administrado mediante Go (vista previa)
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Crear una instancia con ajuste de escala automático administrado mediante Java (vista previa)
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Para autenticarte en Spanner, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Mostrar lista de instancias
Puedes mostrar una lista de tus instancias de Spanner.
Console
Ve a la página Instancias de Spanner en la consola de Google Cloud.
En la consola de Google Cloud, se muestra una lista de tus instancias junto con el ID, el nombre visible, la configuración y capacidad de procesamiento expresada en unidades de procesamiento y en nodos.
gcloud
Usa el comando gcloud spanner instances list
:
gcloud spanner instances list
Gcloud CLI imprime una lista de tus instancias junto con el ID, el nombre visible, la configuración y la capacidad de procesamiento.
Editar una instancia
En las siguientes secciones, se explica cómo cambiar el nombre visible de una instancia y la capacidad de procesamiento. No puedes cambiar el ID ni la configuración de la instancia.
Cómo cambiar el nombre visible
Console
Ve a la página Instancias de Spanner en la consola de Google Cloud.
Haz clic en el nombre de la instancia a la que deseas cambiarle el nombre.
Haz clic en Editar instancia.
Ingresa un nuevo nombre de instancia. Este nombre debe ser único dentro del proyecto de Google Cloud.
Haz clic en Guardar.
gcloud
Usa el comando gcloud spanner instances update
:
gcloud spanner instances update INSTANCE_ID --description=INSTANCE_NAME
Reemplaza lo siguiente:
- INSTANCE_ID: Es el identificador permanente de la instancia.
- INSTANCE_NAME: Es el nombre que se mostrará para la instancia en el Consola de Google Cloud El nombre de la instancia debe ser único en tu proyecto de Google Cloud.
Cambia la capacidad de procesamiento
Debes aprovisionar suficiente capacidad de procesamiento para mantener Uso de CPU y de uso de almacenamiento por debajo de los máximos recomendados. Para obtener más información, consulta las cuotas y límites de Spanner
Hay algunos casos en los que no se puede reducir la capacidad de procesamiento de un instancia existente:
- Quitar capacidad de procesamiento requeriría que tu instancia almacene más de 4 TB de datos por cada 1,000 unidades de procesamiento (1 nodo)
- Según tus patrones de uso históricos, Spanner creó un una gran cantidad de divisiones para tu de la instancia de VM y, en casos excepcionales, Spanner no podría para administrar las divisiones después de quitar la capacidad de procesamiento.
En este último caso, intenta reducir la capacidad de procesamiento de manera progresiva cantidades más pequeñas hasta que encuentres la capacidad mínima que necesita administrar todas las divisiones de la instancia. Si la instancia ya no requiere tantas divisiones debido a un cambio en los patrones de uso, Spanner podría finalmente combinar algunas divisiones y permitirte intentar reducir la capacidad de procesamiento de la instancia después de una o dos semanas.
Cuando quites capacidad de procesamiento, supervisa el uso de CPU latencias en Cloud Monitoring para garantizar que los la utilización se mantiene por debajo del 65% para los y un 45% para cada región en multirregionales. Es posible que experimentes un aumento temporal en la solicitud latencias mientras se quita la capacidad de procesamiento.
Si quieres aumentar la capacidad de procesamiento de una instancia, El proyecto de Google Cloud debe tener una cuota suficiente para agregar el procesamiento la capacidad de procesamiento. El tiempo que demore en completarse la solicitud de aumento depende del el tamaño de la solicitud. En la mayoría de los casos, las solicitudes se completan en pocos minutos. Activada en muy pocas ocasiones, el escalamiento vertical puede tardar hasta una hora en completarse.
Console
Ve a la página Instancias de Spanner en la consola de Google Cloud.
Haz clic en el nombre de la instancia que deseas cambiar.
Haz clic en Editar instancia.
Elige las unidades de medida para cambiar la capacidad de procesamiento (unidades de procesamiento o nodos) y, luego, ingresa una cantidad. Al usar unidades de procesamiento, ingrese cantidades hasta 1000 en múltiplos de 100 (100, 200, 300, etc.) e ingresar cantidades mayores en múltiplos de 1000 (1,000, 2,000, 3,000, etcétera). Cada nodo equivale a 1,000 unidades de procesamiento.
Haz clic en Guardar.
Si ves un cuadro de diálogo que indica que tienes una cuota insuficiente para agregar capacidad de procesamiento en esta ubicación, sigue las instrucciones a fin de solicitar una cuota superior.
gcloud
Usa el comando gcloud spanner instances update
. Cuando uses este comando, especifica la capacidad de procesamiento como una
la cantidad de nodos o unidades de procesamiento.
gcloud spanner instances update INSTANCE_ID --nodes=NODE_COUNT [--async]
o
gcloud spanner instances update INSTANCE_ID --processing-units=PROCESSING_UNIT_COUNT [--async]
Reemplaza lo siguiente:
- INSTANCE_ID: Es el identificador permanente de la instancia.
- NODE_COUNT: La capacidad de procesamiento de la instancia, expresada como cantidad de nodos. Cada nodo equivale a 1,000 unidades de procesamiento.
- PROCESSING_UNIT_COUNT: La capacidad de procesamiento de la instancia. expresada como un número de unidades de procesamiento. Ingresa cantidades de hasta 1,000 en múltiplos de 100 (100, 200, 300, etc.) e ingresa mayor cantidades en múltiplos de 1000 (1000, 2000, 3000, etc.).
Marcas opcionales:
--async
: Usa esta marca si deseas que tu solicitud se muestre de inmediato. sin esperar a que la operación en curso finalice. Puedes consultar el estado de tu solicitud ejecutandogcloud spanner operations describe
Habilita o modifica el escalador automático administrado en una instancia
Las siguientes limitaciones se aplican cuando agregas o cambias el ajuste de escala automático administrado en una instancia existente:
- No puedes habilitar el escalador automático administrado en una instancia que estás moviendo.
No puedes mover una instancia mientras el escalador automático administrado está habilitado.
Console
Ve a la página Instancias de Spanner en la consola de Google Cloud.
Haz clic en el nombre de la instancia en la que quieres habilitar escalador automático.
Haz clic en Editar instancia.
En Configura la capacidad de procesamiento, haz clic en Ajuste de escala automático.
En Minimum, selecciona el límite mínimo que se usará cuando se reduzca la escala verticalmente. Para obtener más información, consulta Determina el límite mínimo.
En Máximo, selecciona el límite máximo que se usará cuando se escala verticalmente. Para para obtener más información, consulta Determina el límite máximo.
En Objetivo de uso de CPU de alta prioridad, selecciona el porcentaje de de alta prioridad para usar. Para obtener más información, consulta Determina el objetivo de uso de CPU.
En Objetivo de uso de almacenamiento, selecciona el porcentaje de almacenamiento que se usará usar. Para obtener más información, consulta Determina el objetivo de uso de almacenamiento.
Haz clic en Guardar.
gcloud
Usa el
gcloud beta spanner instances update
para agregar el escalador automático administrado a una instancia. Para obtener más información y
, consulta Marcas y limitaciones de Google Cloud CLI
.
Puedes agregar el escalador automático administrado con el siguiente comando:
gcloud beta spanner instances update INSTANCE_ID \ --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \ --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
o
gcloud beta spanner instances update INSTANCE_ID \ --autoscaling-min-processing-units=MINIMUM_NODES \ --autoscaling-max-processing-units=MAXIMUM_NODES \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
Reemplaza lo siguiente:
- INSTANCE_ID: Es el identificador permanente de la instancia.
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: el la cantidad mínima de nodos o unidades de procesamiento para reducir la escala verticalmente. Para obtener más información, consulta Determina el límite mínimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: el la cantidad máxima de nodos o unidades de procesamiento para escalar verticalmente. Para más información, consulta Determina el límite máximo.
- CPU_PERCENTAGE: Es el porcentaje objetivo de la CPU de alta prioridad a usan, del 10% al 90%. Si optimizas en función del costo y no necesitas la latencia en todas las solicitudes y, luego, usa un porcentaje más alto. Para ver más información, consulta Determina el objetivo de uso de CPU.
- STORAGE_PERCENTAGE: El porcentaje objetivo de almacenamiento que se usará. de 10% a 99%. Para obtener más información, consulta Determina el objetivo de uso de almacenamiento.
Después de agregar el escalador automático administrado a una instancia, puedes modificar el del escalador automático administrado. Por ejemplo, si quieres aumentar la longitud máxima cantidad de unidades de procesamiento a 10,000, ejecuta el siguiente comando:
gcloud beta spanner instances update test-instance \
--autoscaling-max-processing-units=10000
Cambia una instancia de uso del escalador automático administrado a ajuste de escala manual
Console
Ve a la página Instancias de Spanner en la consola de Google Cloud.
Haz clic en el nombre de la instancia que quieres inhabilitar escalador automático.
En Elegir un modo de escalamiento, haz clic en Asignación manual.
Haz clic en Guardar.
gcloud
Usa la gcloud beta spanner instances update
.
para actualizar la instancia.
Usa el siguiente comando para impedir que una instancia use el rol escalador automático al ajuste de escala manual:
gcloud beta spanner instances update INSTANCE_ID \ --processing-units=PROCESSING_UNIT_COUNT
o
gcloud beta spanner instances update INSTANCE_ID \ --nodes=NODE_COUNT
Reemplaza lo siguiente:
- INSTANCE_ID: Es el identificador permanente de la instancia.
- NODE_COUNT: La capacidad de procesamiento de la instancia, expresada como un número de nodos. Cada nodo equivale a 1,000 unidades de procesamiento.
- PROCESSING_UNIT_COUNT: La capacidad de procesamiento de la instancia. expresada como un número de unidades de procesamiento. Ingresa cantidades de hasta 1,000 en múltiplos de 100 (100, 200, 300, etc.) e ingresa mayor cantidades en múltiplos de 1000 (1000, 2000, 3000, etc.).
Etiqueta una instancia
Etiquetas para organizar tus recursos.
Console
Ve a la página Instancias de Spanner en la consola de Google Cloud.
Selecciona la casilla de verificación de la instancia. El panel de información aparece en el lado derecho de la página.
Haz clic en la pestaña Etiquetas en el panel de información. Luego, puedes agregar, borrar o actualizar etiquetas para la instancia de Spanner.
Traslada una instancia
Si deseas obtener instrucciones para trasladar tu instancia de cualquier configuración de instancias a cualquier otra configuración de instancias, incluso entre instancias regionales y multirregionales consulta Traslada una instancia.
Borra una instancia
Puedes borrar una instancia con la consola de Google Cloud o Google Cloud CLI
Si quieres borrar una instancia que tiene una o más bases de datos con protección contra la eliminación habilitada, primero debes inhabilitar la protección contra la eliminación en todas las bases de datos de esa instancia antes de borrarla.
Console
Ve a la página Instancias de Spanner en la consola de Google Cloud.
Haz clic en el nombre de la instancia que deseas borrar.
Haz clic en Borrar instancia.
Sigue las instrucciones para confirmar que deseas borrar la instancia.
Haz clic en Borrar.
gcloud
Usa la gcloud spanner instances delete
.
comando y reemplaza INSTANCE-ID por el ID de la instancia:
gcloud spanner instances delete INSTANCE-ID
Detén o reinicia una instancia
Spanner es un servicio de base de datos completamente administrado que supervisa sus propias tareas y recursos subyacentes, incluida la supervisión y el reinicio y procesos cuando sea necesario sin tiempo de inactividad. Como no hay necesidad de modificar detener o reiniciar una instancia determinada, Spanner no ofrece hazlo.
¿Qué sigue?
- Aprende a insertar, actualizar y borrar datos con Lenguaje de manipulación de datos (DML) o la CLI de gcloud.
- Otorga roles de Identity and Access Management a la instancia y sus bases de datos.
- Aprende a diseñar un esquema de Spanner.