En esta página, se describe cómo crear, enumerar, editar y borrar instancias de Spanner.
Crea una instancia
Puedes crear una instancia con la consola de Google Cloud, Google Cloud CLI o las bibliotecas cliente. También puedes crear una instancia con una configuración de instancia personalizada si agregas réplicas de solo lectura opcionales.
Console
Ve a la página Crea una 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 ID de la instancia también debe ser único en tu proyecto de Google Cloud. No puedes cambiar el ID de la instancia más tarde.
En Elige una configuración, haz clic en Regional o Multirregional. Como alternativa, si quieres comparar las especificaciones entre dos regiones, haz clic en Comparar configuraciones de las regiones.
Selecciona una configuración del menú desplegable.
Opcional: Agrega réplicas de solo lectura para escalar las lecturas y admitir lecturas inactivas de baja latencia. Cuando creas y agregas una réplica de solo lectura a una configuración de instancia con la consola de Google Cloud, la configuración de la instancia personalizada se crea automáticamente. Para agregar una réplica de solo lectura, haz lo siguiente:
Expande Configurar réplicas de solo lectura.
Haz clic en Agregar réplica de solo lectura.
Selecciona una región y un número.
En la sección Configura la capacidad de procesamiento, en Seleccionar unidad, haz clic en una de las siguientes opciones:
- Unidades de procesamiento para instancias pequeñas.
- Nodos para instancias grandes. Un nodo equivale a 1,000 unidades de procesamiento.
Para obtener más información, consulta Capacidad de procesamiento, nodos y unidades de procesamiento.
En Elige un modo de escalamiento, haz clic en una de las siguientes opciones:
Asignación manual si deseas configurar de forma manual la capacidad de procesamiento para recursos de procesamiento y costos fijos.
- La Cantidad indica la cantidad de nodos o unidades de procesamiento que se usarán en esta instancia.
Ajuste de escala automático (Vista previa), para permitir que Spanner agregue y quite capacidad de procesamiento de forma automática. Para obtener más información sobre el escalador automático administrado, consulta Escalador automático administrado para Spanner. Configura las siguientes opciones del 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 la capacidad de procesamiento. Para obtener más información, consulta Determina el límite mínimo.
- Máximo indica el límite máximo que se debe escalar verticalmente, según la unidad de medida que elijas para la Capacidad de procesamiento. Para obtener más información, consulta Determina el límite máximo.
- El objetivo de uso de CPU de alta prioridad indica el porcentaje objetivo 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 que se 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 el comando gcloud spanner instances create
para crear una instancia. Especifica la capacidad de procesamiento como la cantidad de nodos o unidades de procesamiento que quieres usar 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: Un identificador permanente de la configuración de tu instancia, que define la ubicación geográfica de la instancia y afecta la forma en que se replican los datos. Para la configuración de instancias personalizadas, comienza con
custom-
. Para obtener más información, consulta Configuraciones de instancias. - INSTANCE-DESCRIPTION: Es el nombre que se mostrará para la instancia en la 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 una cantidad de nodos. Cada nodo equivale a 1,000 unidades de procesamiento.
PROCESSING-UNIT-COUNT: La capacidad de procesamiento de la instancia, expresada como una cantidad de unidades de procesamiento. Ingresa cantidades hasta 1,000 en múltiplos de 100 (100, 200, 300 y así sucesivamente) e ingresa cantidades mayores en múltiplos de 1,000 (1,000, 2,000, 3,000 y así sucesivamente). Nota: No uses este parámetro si creas una instancia que quieras 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 que usen el ajuste de escala automático administrado con el comando gcloud beta spanner instances create
. Si deseas obtener más información, consulta Escalador automático administrado para Spanner.
Usa el siguiente comando para crear una instancia con 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: 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: Un identificador permanente de la configuración de tu instancia, que define la ubicación geográfica de la instancia y afecta la forma en que se replican los datos. Para la configuración de instancias personalizadas, comienza con
custom-
. Para obtener más información, consulta Configuraciones de instancias. - INSTANCE-DESCRIPTION: Es el nombre que se mostrará para la instancia en la consola de Google Cloud. El nombre de la instancia debe ser único en tu proyecto de Google Cloud.
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: Es la cantidad mínima de nodos o unidades de procesamiento cuando se reduce el escalamiento. Para obtener más información, consulta Determina el límite mínimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: Es la cantidad máxima de nodos o unidades de procesamiento cuando se escala verticalmente. Para obtener más información, consulta Determina el límite máximo.
- CPU_PERCENTAGE: Es el porcentaje objetivo de la CPU de alta prioridad que se usará, del 10 al 90%. Si quieres optimizar el costo, usa un porcentaje más alto. Para obtener más información, consulta Determina el objetivo de uso de CPU.
- STORAGE_PERCENTAGE: Es el porcentaje objetivo de almacenamiento que se usará, del 10 al 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 configuración de instancia regional base 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 configuración de instancia multirregional personalizada custom-eur6
, primero debes crear una configuración de instancia 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 ejecutar cualquiera 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.
Crea 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.
Crea 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.
Rita
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 las instancias de Spanner, junto con el ID, el nombre visible, la configuración y la capacidad de procesamiento de cada instancia, expresados 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 de Spanner, junto con el ID, el nombre visible, la configuración y la capacidad de procesamiento de cada instancia.
Editar una instancia
En las siguientes secciones, se explica cómo cambiar el nombre visible y la capacidad de procesamiento de una instancia. 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: El identificador permanente de la instancia.
- INSTANCE-NAME: Es el nombre que se mostrará para la instancia en la 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 el uso de CPU y el uso del almacenamiento por debajo de los valores máximos recomendados. Para obtener más información, consulta Cuotas y límites de Spanner.
Existen algunos casos en los que no puedes reducir la capacidad de procesamiento de una instancia existente:
- Quitar la capacidad de procesamiento requeriría que la instancia almacene más de 4 TB de datos por cada 1,000 unidades de procesamiento (1 nodo).
- En función de tus patrones de uso históricos, Spanner creó una gran cantidad de divisiones para los datos de la instancia y, en algunos casos excepcionales, Spanner no podría administrar las divisiones después de quitar la capacidad de procesamiento.
En el último caso, puedes intentar reducir la capacidad de procesamiento a cantidades cada vez más pequeñas hasta encontrar la capacidad mínima que Spanner necesita para 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 combinar algunas divisiones y permitirte intentar reducir aún más la capacidad de procesamiento de la instancia después de una o dos semanas.
Cuando quites capacidad de procesamiento, supervisa el uso de CPU y las latencias de solicitudes en Cloud Monitoring para asegurarte de que el uso de CPU se mantenga por debajo del 65% en las instancias regionales y del 45% para cada región en las instancias multirregionales. Es posible que experimentes un aumento temporal en la latencia de las solicitudes mientras quitas la capacidad de procesamiento.
Si deseas aumentar la capacidad de procesamiento de una instancia, tu proyecto de Google Cloud debe tener una cuota suficiente para agregar esa capacidad.
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.
Para cambiar la capacidad de procesamiento, elige las unidades de medición (unidades de procesamiento o nodos) y, luego, ingresa una cantidad. Cuando uses unidades de procesamiento, ingresa cantidades hasta 1,000 en múltiplos de 100 (100, 200, 300, etc.) e ingresa cantidades mayores en múltiplos de 1,000 (1,000, 2,000, 3,000 y así sucesivamente). 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 cantidad de nodos o unidades de procesamiento.
gcloud spanner instances update INSTANCE-ID --nodes=NODE-COUNT
o
gcloud spanner instances update INSTANCE-ID --processing-units=PROCESSING-UNIT-COUNT
Reemplaza lo siguiente:
- INSTANCE-ID: El identificador permanente de la instancia.
- NODE-COUNT: La capacidad de procesamiento de la instancia, expresada como una cantidad de nodos. Cada nodo equivale a 1,000 unidades de procesamiento.
- PROCESSING-UNIT-COUNT: La capacidad de procesamiento de la instancia, expresada como una cantidad de unidades de procesamiento. Ingresa cantidades hasta 1,000 en múltiplos de 100 (100, 200, 300 y así sucesivamente) e ingresa cantidades mayores en múltiplos de 1,000 (1,000, 2,000, 3,000 y así sucesivamente).
Habilita o modifica el escalador automático administrado en una instancia
Las siguientes limitaciones se aplican cuando agregas o cambias la función de 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 deseas habilitar el escalador automático administrado.
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. 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á durante el escalamiento vertical. 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 CPU de alta prioridad que se 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á. Para obtener más información, consulta Determina el objetivo de uso de almacenamiento.
Haz clic en Guardar.
gcloud
Usa el comando gcloud beta spanner instances update
para agregar el escalador automático administrado a una instancia. Para obtener más información y limitaciones, consulta Marcas y limitaciones de Google Cloud CLI
.
Puedes agregar el escalador automático administrado con el siguiente comando:
gcloud beta spanner instances update \ --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 \ --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:
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: Es la cantidad mínima de nodos o unidades de procesamiento que se usarán cuando se reduzca la escala. Para obtener más información, consulta Determina el límite mínimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: La cantidad máxima de nodos o unidades de procesamiento que se usarán cuando se escala verticalmente Para obtener más información, consulta Determina el límite máximo.
- CPU_PERCENTAGE: Es el porcentaje objetivo de la CPU de alta prioridad que se usará, del 10% al 90%. Si quieres optimizar el costo y no necesitas una latencia baja en todas las solicitudes, usa un porcentaje más alto. Para obtener más información, consulta Determina el objetivo de uso de CPU.
- STORAGE_PERCENTAGE: Es el porcentaje objetivo de almacenamiento que se usará, del 10% al 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, también puedes modificar la configuración del escalador automático administrado. Por ejemplo, si quieres aumentar la cantidad máxima de unidades de procesamiento a 10,000, ejecuta el siguiente comando:
gcloud beta spanner instances update \
--autoscaling-max-processing-units=10000
Cambia una instancia de usar el 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 en la que deseas inhabilitar el escalador automático administrado.
En Elige un modo de escalamiento, haz clic en Asignación manual.
Haz clic en Guardar.
gcloud
Usa el comando gcloud beta spanner instances update
para actualizar la instancia.
Usa el siguiente comando para cambiar una instancia del escalador automático administrado al ajuste de escala manual:
gcloud beta spanner instances update \ --processing-units=PROCESSING-UNITS-COUNT
o
gcloud beta spanner instances update \ --nodes=NODE-COUNT
Reemplaza PROCESSING-UNIT-COUNT o NODE-COUNT por la cantidad de nodos o unidades de procesamiento que quieres usar en la instancia.
Etiqueta una instancia
Las etiquetas ayudan a 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 del panel de información. Luego, puedes agregar, borrar o actualizar las etiquetas de la instancia de Spanner.
Cómo mover una instancia
Si deseas obtener instrucciones para trasladar tu instancia de cualquier configuración de instancia a cualquier otra configuración de instancias, incluso entre configuraciones regionales y multirregionales, consulta Mueve una instancia.
Borra una instancia
Puedes borrar una instancia con la consola de Google Cloud o Google Cloud CLI.
Si deseas borrar una instancia que tiene una o más bases de datos con la 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 poder borrar la instancia.
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 el comando gcloud spanner instances delete
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 propios recursos y tareas subyacentes, incluida la supervisión y el reinicio de procesos cuando es necesario sin tiempo de inactividad. Como no es necesario detener o reiniciar una instancia determinada de forma manual, Spanner no ofrece una manera de hacerlo.
¿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 Identity and Access Management para la instancia y sus bases de datos.
- Aprende a diseñar un esquema de Spanner.