Cambia el quórum birregional

En esta página, se describe cómo verificar el estado del quórum de región doble de Spanner y cómo cambiar el quórum de forma manual en caso de interrupciones del servicio.

Para obtener más información sobre estas regiones, consulta Configuración de instancias birregionales de Spanner.

Verifica el estado del quórum birregional

Puedes verificar el estado del quórum birregional de las siguientes maneras.

  • En la página Descripción general de la base de datos.
  • Cómo usar el panel Estadísticas del sistema

En la página de descripción general de la base de datos

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

    Ir a la página Instancias

  2. Haz clic en el nombre de la instancia que está en una configuración birregional.

  3. Haz clic en el nombre de la base de datos.

  4. En Descripción general, busca la fila Quórum, que muestra el estado del quórum birregional de tu instancia:

    • Si se cumple quórum en ambas regiones, el estado se mostrará como Dual-region.

    • Si se realizó una conmutación por error manual o administrada por Google, verás el nombre de la región de entrega (por ejemplo, asia-south1).

Panel de estadísticas del sistema

Después de crear una configuración birregional, puedes ver la métrica Disponibilidad de quórum birregional en el panel de estadísticas del sistema a nivel de la instancia.

Para obtener más información, consulta Visualiza el panel de estadísticas del sistema.

Cambia el quórum birregional de birregional a una sola región (conmutación por error)

Para realizar la conmutación por error de forma manual si hay una interrupción regional o un problema de partición de la red, haz lo siguiente:

Consola de Google Cloud

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

    Ir a la página Instancias

  2. Haz clic en el nombre de la instancia que está en una configuración birregional.

  3. Haz clic en Estadísticas del sistema en el menú de navegación.

  4. Busca la métrica Disponibilidad de quórum birregional.

  5. Si la métrica de disponibilidad de quórum birregional muestra que hay una interrupción en una región, haz clic en Ícono del botón Activa Cloud Shell Activar Cloud Shell en la parte superior de la consola de Google Cloud.

    Se abrirá Cloud Shell.

  6. Para cambiar el quórum birregional de una región doble a una única, ingresa el siguiente comando que se encuentra en la pestaña de gcloud CLI: gcloud spanner databases change-quorum. Para obtener instrucciones detalladas, consulta la pestaña gcloud.

gcloud CLI

Usa el comando gcloud spanner databases change-quorum para cambiar el quórum birregional de una región doble a una única.

gcloud spanner databases change-quorum
    DATABASE_ID --instance=INSTANCE_ID
    --single-region --serving-location=SERVING_LOCATION
    [--etag=ETAG]

Reemplaza lo siguiente:

  • DATABASE_ID: Es el identificador permanente de la base de datos.

  • INSTANCE_ID: Identificador permanente de la instancia.

  • SERVING_LOCATION: Es la configuración de la instancia regional a la que deseas conmutar por error. Por ejemplo, si asia-south1 (Bombay) no está en buen estado y deseas realizar una conmutación por error a asia-south2 (Delhi), ingresa asia-south2. Asegúrate de que SERVING_LOCATION sea la región en buen estado. Si eliges una región incorrecta para la conmutación por error, la base de datos no estará disponible, lo cual no se podrá recuperar antes de que la región vuelva a estar en línea.

Marcas opcionales:

  • --etag=ETAG: Se puede usar el argumento ETAG para proteger la reproducción.

Para verificar el estado de la operación de cambio de quórum, ejecuta el comando gcloud spanner databases describe. El campo quorumInfo proporciona información sobre la operación.

gcloud spanner databases describe DATABASE_ID
    --instance=INSTANCE_ID

Cambia el quórum birregional de una sola región a birregional (conmutación por recuperación)

Para realizar una conmutación por recuperación manual después de que la región interrumpida esté en buen estado o después de que se resuelva el problema de partición de red, haz lo siguiente:

Consola de Google Cloud

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

    Ir a la página Instancias

  2. Haz clic en el nombre de la instancia que está en una configuración birregional.

  3. Haz clic en Estadísticas del sistema en el menú de navegación.

  4. Busca la métrica Disponibilidad de quórum birregional.

  5. En la métrica Disponibilidad de quórum birregional, haz clic en Cambiar quórum de la región.

    Se abrirá Cloud Shell.

  6. Para cambiar el quórum birregional de una región doble a una única, ingresa el siguiente comando que se encuentra en la pestaña de gcloud CLI: gcloud spanner databases change-quorum. Para obtener instrucciones detalladas, consulta la pestaña gcloud.

gcloud CLI

Usa el comando gcloud spanner databases change-quorum para cambiar el quórum birregional de una sola región a birregional.

gcloud spanner databases change-quorum
    DATABASE_ID --instance=INSTANCE_ID
    --dual-region
    [--etag=ETAG]

Reemplaza lo siguiente:

  • DATABASE_ID: Es el identificador permanente de la base de datos.

  • INSTANCE_ID: Identificador permanente de la instancia.

Marcas opcionales:

  • --etag=ETAG: El argumento ETAG se puede usar para el control de simultaneidad optimista.

Para verificar el estado de la operación de cambio de quórum, ejecuta el comando gcloud spanner databases describe. El campo quorumInfo proporciona información sobre la operación.

gcloud spanner databases describe DATABASE_ID
    --instance=INSTANCE_ID

¿Qué sigue?