Crea y administra instancias

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

  1. Ve a la página Crear una instancia en Cloud Console.

    Crear una instancia

  2. 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.
  3. 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:

Captura de pantalla de la página de creación de instancias

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.

Ir a la página Instancias

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

  1. Ve a la página Instancias de Spanner en Cloud Console.

    Ir a la página Instancias

  2. Haz clic en el nombre de la instancia a la que deseas cambiarle el nombre.

  3. Haz clic en Editar instancia.

  4. Ingresa un nuevo nombre de instancia. Este nombre debe ser único dentro del proyecto de Google Cloud.

  5. 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.
  • En función de tus patrones de uso históricos, Cloud Spanner creó una gran cantidad de divisiones para los datos de tu instancia y no podría administrarlas después de quitar los 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

  1. Ve a la página Instancias de Spanner en Cloud Console.

    Ir a la página Instancias

  2. Haz clic en el nombre de la instancia que deseas cambiar.

  3. Haz clic en Editar instancia.

  4. Ingresa la cantidad de nodos que deseas.

  5. 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

  1. Ve a la página Instancias de Spanner en Cloud Console.

    Ir a la página Instancias

  2. Haz clic en el nombre de la instancia que deseas borrar.

  3. Haz clic en Borrar instancia.

  4. Sigue las instrucciones para confirmar que deseas borrar la instancia.

  5. 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