En esta página, se describe cómo crear, enumerar, editar y borrar instancias de Cloud Spanner.
Crea una instancia
Puedes crear una instancia con la CLI de Google Cloud o con Google Cloud Console.
Console
Ve a la página Crear una instancia en Cloud Console.
Ingresa los siguientes valores:
- Un nombre de instancia para mostrar en Cloud Console El nombre de la instancia debe ser único en tu proyecto de Google Cloud.
- Un ID de instancia (Instance ID) para identificar de forma permanente tu instancia. 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.
- Una configuración, que define la ubicación geográfica de la instancia y afecta la forma en que se replican los datos. Obtén más información sobre la configuración de instancias.
- La cantidad de capacidad de procesamiento de la instancia. La capacidad de procesamiento determina la cantidad de recursos de entrega y almacenamiento que están disponibles para las bases de datos de la instancia. Para especificar la capacidad de procesamiento, elige las unidades de medida (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.) y, luego, 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. Obtén más información sobre las unidades de procesamiento y los nodos.
Haga clic en Crear para crear la instancia.
gcloud
Usa el comando gcloud spanner instances create
. Cuando uses este comando, especifica la capacidad de procesamiento como un número de nodos o unidades de procesamiento.
gcloud spanner instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
--description="[INSTANCE-NAME]" --nodes=[NODE-COUNT]
o
gcloud spanner instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
--description="[INSTANCE-NAME]" --processing-units=[PROCESSING-UNIT-COUNT]
Ingresa los siguientes valores:
[INSTANCE-ID]
: 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]
: 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. Obtén más información sobre la configuración de instancias.[INSTANCE-NAME]
: El nombre que se mostrará para la instancia en Cloud Console. 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) y, luego, ingresa cantidades mayores en múltiplos de 1,000 (1,000, 2,000, 3,000 y así sucesivamente).
Por ejemplo:
gcloud spanner instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Deberías ver un mensaje similar al siguiente ejemplo:
Creating instance...done.
C++
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Spanner, consulta Bibliotecas cliente de Cloud Spanner.
C#
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Spanner, consulta Bibliotecas cliente de Cloud Spanner.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Spanner, consulta Bibliotecas cliente de Cloud Spanner.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Spanner, consulta Bibliotecas cliente de Cloud Spanner.
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Spanner, consulta Bibliotecas cliente de Cloud Spanner.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Spanner, consulta Bibliotecas cliente de Cloud Spanner.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Spanner, consulta Bibliotecas cliente de Cloud Spanner.
Ruby
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Spanner, consulta Bibliotecas cliente de Cloud Spanner.
Genera una lista de instancias
Console
Ve a la página Instancias de Spanner en Cloud Console.
Cloud Console muestra una lista de tus instancias de Cloud Spanner, junto con cada ID de instancia, nombre visible, 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
La CLI de gcloud muestra una lista de tus instancias de Cloud Spanner, junto con cada ID de instancia, nombre visible, configuración y capacidad de procesamiento.
Edita 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.
Cambia el nombre visible
Console
Ve a la página Instancias de Spanner en Cloud Console.
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]
Ingresa los siguientes valores:
[INSTANCE-ID]
: Identificador permanente de la instancia.[INSTANCE-NAME]
: El nombre que se mostrará para la instancia en Cloud Console. 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 de almacenamiento por debajo de los máximos recomendados. Para obtener más información, consulta las cuotas y límites de Cloud 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 tu instancia almacene más de 4 TB de datos por cada 1,000 unidades de procesamiento (1 nodo).
- Debido a tus patrones de uso históricos, Cloud Spanner creó una gran cantidad de divisiones para tus datos y, en algunos casos, Cloud 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 en cantidades progresivamente más pequeñas hasta encontrar la capacidad mínima que necesita Cloud Spanner para administrar todas las divisiones de la instancia. Si la instancia ya no necesita tantas divisiones debido a un cambio en los patrones de uso, Cloud Spanner puede combinar algunas divisiones y permitirte intentar reducir la capacidad de procesamiento de la instancia después de una o dos semanas.
Cuando quites la capacidad de procesamiento, supervisa el uso de CPU y solicita latencias en Cloud Monitoring a fin de asegurarte de que el uso de CPU se mantenga por debajo del 65% para las instancias regionales y del 45% para cada región en instancias multirregionales. Es posible que experimentes un aumento temporal en la latencia de las solicitudes mientras se quita la capacidad de procesamiento.
Si quieres aumentar la capacidad de procesamiento de una instancia, tu proyecto de Google Cloud debe tener cuota suficiente para agregar la capacidad de procesamiento.
Console
Ve a la página Instancias de Spanner en Cloud Console.
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 medida (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.) y, luego, ingresa cantidades más grandes 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 un número 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]
Ingresa los siguientes valores:
[INSTANCE-ID]
: 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) y, luego, ingresa cantidades mayores en múltiplos de 1,000 (1,000, 2,000, 3,000 y así sucesivamente).
Etiquetar una instancia
Etiquetas para organizar tus recursos.
Console
Ve a la página Instancias de Spanner en Cloud Console.
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 Cloud Spanner.
Borra una instancia
Console
Ve a la página Instancias de Spanner en Cloud Console.
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
Cloud 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 de los procesos cuando es necesario sin tiempo de inactividad. Como no es necesario detener o reiniciar una instancia determinada de forma manual, Cloud 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 funciones de IAM para la instancia y sus bases de datos.
- Obtén información sobre cómo diseñar un esquema de Cloud Spanner.