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 herramienta de línea de comandos de gcloud 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 (Instance name) 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 los nodos 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 nodos (Nodes) para la instancia. La cantidad de nodos determina la cantidad de recursos de almacenamiento y entrega que están disponibles para las bases de datos de la instancia.
Haz clic en Crear (Create) para crear la instancia.
En la siguiente captura de pantalla, se muestra la página de creación de la instancia:
gcloud
Usa el comando gcloud spanner instances create:
gcloud spanner instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
--description="[INSTANCE-NAME]" --nodes=[NODE-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 los nodos 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 cantidad de nodos para la instancia. La cantidad de nodos determina la cantidad de recursos de almacenamiento y entrega que están disponibles para las bases de datos de la instancia.
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.
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 el ID, el nombre visible, la configuración y la cantidad de nodos de cada instancia.
gcloud
Usa el comando gcloud spanner instances list:
gcloud spanner instances list
La herramienta de gcloud muestra una lista de tus instancias de Cloud Spanner, junto con el ID, el nombre visible, la configuración y la cantidad de nodos de cada instancia.
Edita una instancia
En las siguientes secciones, se explica cómo cambiar el nombre visible y la cantidad de nodos 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 cantidad de nodos
Debes aprovisionar suficientes nodos para satisfacer tus necesidades de almacenamiento y mantener el uso de CPU por debajo de los valores máximos recomendados. Para obtener más información sobre los recursos proporcionados por un nodo, consulta la página sobre cuotas y límites de Cloud Spanner.
Hay algunos casos en los que no puedes quitar nodos de una instancia existente:
- Si borras los nodos, la instancia deberá almacenar más de 2 TB de datos por nodo.
- Debido a tu historial de uso, Cloud Spanner creó una gran cantidad de divisiones para los datos de tu instancia y no podrá administrarlas si quitas los nodos.
Cuando quites nodos, supervisa el uso de CPU y solicita latencias 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 de las instancias multirregionales. Es posible que experimentes un aumento temporal en las latencias de solicitudes mientras quitas nodos.
Si deseas aumentar la cantidad de nodos en una instancia, tu proyecto de Google Cloud debe tener una cuota suficiente para agregar los nodos.
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.
Ingresa la cantidad de nodos que deseas.
Haz clic en Guardar.
Si ves un cuadro de diálogo que indica que tienes una cuota insuficiente para agregar nodos en esta ubicación, sigue las instrucciones a fin de solicitar una cuota superior.
gcloud
Usa el comando gcloud spanner instances update:
gcloud spanner instances update [INSTANCE-ID] --nodes=[NODE-COUNT]
Ingresa los siguientes valores:
[INSTANCE-ID]: Identificador permanente de la instancia.[NODE-COUNT]: La cantidad de nodos para la instancia.
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]
Próximos pasos
- Obtén más información sobre cómo insertar, actualizar y borrar datos con el lenguaje de manipulación de datos (DML) o la herramienta 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.