Administrar réplicas de lectura

En esta página se explica cómo inhabilitar y habilitar la replicación de réplicas de lectura, además de cómo promocionar una réplica a una instancia independiente o eliminarla.

Inhabilitar replicaciones

De forma predeterminada, las réplicas se inician con la replicación habilitada. Sin embargo, puedes inhabilitar la replicación en determinadas situaciones; por ejemplo, para depurar o analizar el estado de una instancia. Cuando lo consideres, puedes volver a habilitar la replicación de forma explícita. Al hacer cualquiera de esas operaciones, la réplica se reinicia.

Inhabilitar la replicación no implica que se detenga la instancia de réplica sino que se convierte en una instancia de solo lectura que deja de replicarse desde su instancia maestra. Se te seguirá cobrando por la instancia. Cuando lo consideres, puedes volver a habilitar la replicación de la réplica inhabilitada, eliminar la réplica o promocionarla a una instancia independiente. No puedes detener la réplica.

Para inhabilitar la replicación, efectúa los pasos siguientes:

Consola

  1. Visita la página de instancias de Cloud SQL en la consola de Google Cloud Platform.

    Ir a la página de instancias de Cloud SQL

  2. Haz clic en el nombre de una instancia de réplica para abrirla.
  3. Haz clic en Inhabilitar replicación en la barra de botones.
  4. Haz clic en Aceptar.

gcloud

gcloud sql instances patch [REPLICA_NAME] --no-enable-database-replication

cURL

Para ejecutar este comando cURL en el símbolo de la línea de comandos, adquiere un token de acceso mediante el comando gcloud auth application-default print-access-token. También puedes usar el Explorador de API en la página Instances:patch para enviar la petición de la API REST.

ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{"settings": {"databaseReplicationEnabled" : "False" }}' \
     -X PATCH \
     https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[REPLICA_NAME]

Habilitar replicaciones

Si no se ha replicado una réplica durante mucho tiempo, tardará más en ponerse al día con la maestra. En este caso, se recomienda eliminar la réplica y crear una nueva.

Para habilitar la replicación, efectúa los pasos siguientes:

Consola

  1. Visita la página de instancias de Cloud SQL en la consola de Google Cloud Platform.

    Ir a la página de instancias de Cloud SQL

  2. Haz clic en el nombre de una instancia de réplica para seleccionarla.
  3. Haz clic en Habilitar replicación en la barra de botones.
  4. Haz clic en Aceptar.

gcloud

gcloud sql instances patch [REPLICA_NAME] --enable-database-replication

cURL

Para ejecutar este comando cURL en el símbolo de la línea de comandos, adquiere un token de acceso mediante el comando gcloud auth application-default print-access-token. También puedes usar el Explorador de API en la página Instances:patch para enviar la petición de la API REST.

ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{"settings": {"databaseReplicationEnabled" : "True" }}' \
     -X PATCH \
     https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[REPLICA_NAME]

Promocionar réplicas

Promocionar una réplica a una instancia de Cloud SQL independiente es una acción irreversible. Una vez promocionada, la instancia no podrá volver a ser una réplica de lectura.

Para promocionar una réplica en una instancia independiente, efectúa los pasos siguientes:

Consola

  1. Visita la página de instancias de Cloud SQL en la consola de Google Cloud Platform.

    Ir a la página de instancias de Cloud SQL

  2. Haz clic en el nombre de una instancia de réplica para seleccionarla.
  3. Haz clic en Promover réplica en la barra de botones.
  4. Haz clic en Aceptar.

gcloud

gcloud sql instances promote-replica [REPLICA_NAME]
  

cURL

Para ejecutar este comando cURL en el símbolo de la línea de comandos, adquiere un token de acceso mediante el comando gcloud auth application-default print-access-token. También puedes usar el Explorador de API en la página Instances:promoteReplica para enviar la petición de la API REST.

ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Length: 0' \
     -X POST \
     https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[REPLICA_NAME]/promoteReplica

Comprobar el estado de replicación

Cuando inicies sesión en una instancia de réplica individual mediante un cliente de administración, obtendrás detalles sobre la replicación, incluidos el estado y las métricas. Cuando uses la consola de Google Cloud Platform o la herramienta de línea de comandos gcloud, obtendrás un breve resumen de la replicación.

Para comprobar el estado de la replicación, efectúa los pasos siguientes:

Consola

  1. Visita la página de instancias de Cloud SQL en la consola de Google Cloud Platform.

    Ir a la página de instancias de Cloud SQL

  2. Haz clic en el nombre de una instancia de réplica para seleccionarla.
  3. El estado de replicación se muestra en un banner en la parte superior de la página.

gcloud

Para una instancia de réplica, comprueba el estado de la replicación con:

gcloud sql instances describe [REPLICA_NAME]

En el resultado, busca las propiedades databaseReplicationEnabled y masterInstanceName.

En el caso de una instancia maestra, comprueba si hay réplicas con:

gcloud sql instances describe [MASTER_INSTANCE_NAME]

En el resultado, busca la propiedad replicaNames.

Siguientes pasos