Usar un archivo de volcado para configurar la replicación desde bases de datos externas

En esta página se describe el proceso para configurar la replicación cuando tienes un archivo de volcado que has creado desde tu servidor externo.

Debes completar todos los pasos de esta página. Cuando termine, podrá administrar y monitorizar la instancia de representación de origen de la misma forma que cualquier otra instancia de Cloud SQL.

Antes de empezar

Antes de empezar, debes configurar el servidor externo, crear la instancia de representación de origen y configurar la réplica de Cloud SQL.

Actualizar los permisos del usuario de replicación

El usuario de replicación del servidor externo está configurado para aceptar conexiones de cualquier host (%). Debes actualizar esta cuenta de usuario para que solo se pueda usar con la réplica de Cloud SQL. Abre un terminal en el servidor externo e introduce estos comandos:

    UPDATE mysql.user
      SET Host='NEW_HOST'
      WHERE Host='OLD_HOST'
      AND User='USERNAME';
      GRANT REPLICATION SLAVE, EXECUTE
      ON *.* TO 'GCP_USERNAME'@'HOST';
    FLUSH PRIVILEGES;

    UPDATE mysql.user
      SET Host='192.0.2.0'
      WHERE Host='%'
      AND User='replicationUser';
      GRANT REPLICATION SLAVE, EXECUTE
      ON *.* TO 'gcp_user'@'gmail.com';
    FLUSH PRIVILEGES;

Verificar la configuración de la replicación

Una vez que hayas completado la configuración, asegúrate de que la réplica de Cloud SQL pueda replicar desde el servidor externo.

Primero, comprueba que la configuración de sincronización externa sea correcta. Para ello, usa los comandos que se indican a continuación para verificarlo:

• Conectividad entre la réplica de Cloud SQL y el servidor externo
• Privilegios de usuario de replicación
• Compatibilidad de versiones
• La réplica de Cloud SQL aún no está replicando
• Los registros binarios están habilitados en el servidor externo
• Se ha habilitado un identificador de transacción global (GTID)

Abre un terminal e introduce estos comandos para verificar que los ajustes de sincronización externa son correctos:

gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{
         "syncMode": "SYNC_MODE",
         "skipVerification": "SKIP_VERIFICATION"
       }' \
     -X POST \
     https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_INSTANCE/verifyExternalSyncSettings

gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{
         "syncMode": "online",
       }' \
     -X POST \
     https://sqladmin.googleapis.com/sql/v1beta4/projects/myproject/instances/myreplica/verifyExternalSyncSettings

Exportar una base de datos a un segmento de Cloud Storage

Puedes rellenar una réplica de Cloud SQL con un archivo mysqldump ubicado en un segmento de Cloud Storage. Se aplican las siguientes condiciones:

• Debes usar la utilidad mysqldump incluida en MySQL.
• Mientras se ejecuta mysqldump, no realices ninguna operación DDL en el servidor externo. Si lo hace, podría haber incoherencias en el archivo de exportación.

Para exportar tu base de datos a un segmento de Cloud Storage, sigue estos pasos:

1. En Google Cloud, crea un segmento de Cloud Storage.
2. Abre un terminal con un cliente que se conecte al servidor de la base de datos externa y ejecuta el siguiente comando.

    mysqldump \
        --host=EXTERNAL_HOST \
        --port=EXTERNAL_PORT \
        --user=USERNAME\
        --password=PASSWORD \
        --databases=DATABASE_LIST  \
        --hex-blob \
        SOURCE_DATA  \
        --no-autocommit \
        --default-character-set=utf8mb4 \
        --single-transaction \
        --set-gtid-purged=on \
        ADD_DROP_TABLE \
        ROUTINES \
        COMPRESS \
        GZIP \
        | gcloud storage cp - gs://BUCKET/DUMP_FILENAME

    mysqldump \
        --host=192.0.2.1 \
        --port=3306 \
        --user=replicationUser \
        --password \
        --databases guestbook journal \
        --hex-blob \
        --master-data=1 \
        --no-autocommit \
        --default-character-set=utf8mb4 \
        --single-transaction \
        --compress \
        | gzip \
        | gcloud storage cp - gs://replica-bucket/external-database.sql.gz

Actualiza la instancia de representación de origen con la ruta de archivo del segmento de Cloud Storage

La instancia de representación de origen es una instancia de Cloud SQL que representa el servidor de base de datos de origen en la réplica de Cloud SQL. Se puede ver en la Google Cloud consola y tiene el mismo aspecto que una instancia de Cloud SQL normal, pero no contiene datos, no requiere configuración ni mantenimiento y no afecta a la facturación.

El archivo source.json contiene información sobre la instancia de representación de origen.

{
  "name": "PRIMARY_INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DB_NAME_AND_VERSION",
  "onPremisesConfiguration": {
    "hostPort": "IP_ADDRESS_AND_PORT",
    "username": "USERNAME",
    "password": "PASSWORD"
  },
  "dumpFilePath" :"DUMP_FILE_PATH"
}

{
  "name": "cloudsql-source-instance",
  "region": "us-central1",
  "databaseVersion": "MYSQL_5_7",
  "onPremisesConfiguration": {
    "hostPort": "192.0.2.0:3306",
    "username": "replicationUser",
    "password": "486#@%*@"
  },
  "dumpFilePath" :"gs://replica-bucket/source-database.sql.gz"
}

Después de configurar la réplica de Cloud SQL, debes actualizar la instancia de representación de origen con la ruta de archivo del segmento de Cloud Storage.

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         --header 'Content-Type: application/json' \
         --data @JSON_PATH \
         -X PATCH \
         https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/SOURCE_REPRESENTATION_INSTANCE

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         --header 'Content-Type: application/json' \
         --data @./source.json \
         -X PATCH \
         https://sqladmin.googleapis.com/sql/v1beta4/projects/MyProject/instances/cloudsql-source-instance

Iniciar la replicación en el servidor externo

Una vez que haya verificado que puede replicar desde el servidor externo, podrá realizar la replicación.

Durante el proceso de importación inicial, no realice ninguna operación de DDL en el servidor externo. Si lo hace, podría haber incoherencias durante la importación. Una vez que se completa el proceso de importación, la réplica usa los registros binarios del servidor externo para ponerse al día con el estado actual del servidor externo.

Abre un terminal, inicia sesión con gcloud y, a continuación, introduce el comando curl para replicar desde el servidor externo.

  gcloud auth login
  ACCESS_TOKEN="$(gcloud auth print-access-token)"
  curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
       --header 'Content-Type: application/json' \
       --data '{
           "syncMode": "SYNC_MODE",
           "skipVerification": "SKIP_VERIFICATION"
         }' \
       -X POST \
       https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_INSTANCE/startExternalSync

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         --header 'Content-Type: application/json' \
         --data '{
             "syncMode": "online",
             "skipVerification": false
           }' \
         -X POST \
         https://sqladmin.googleapis.com/sql/v1beta4/projects/MyProject/instances/replica-instance/startExternalSync

Liberar espacio de almacenamiento

Si has replicado desde un archivo de un contenedor, puedes eliminar este archivo y el contenedor. Consulta la documentación de Cloud Storage sobre cómo eliminar objetos y eliminar segmentos.

Continuar con la replicación

Una vez que inicies la replicación desde el servidor externo, tendrás que monitorizarla y, a continuación, completar la migración. Para obtener más información, consulta Monitorizar la replicación.

Solucionar problemas

Revisar los registros de replicación

Cuando verifiques la configuración de la réplica, se generarán registros.

Para ver estos registros, sigue estos pasos:

1. Ve al visualizador de registros de la Google Cloud consola.

   Ir al visualizador de registros

2. Selecciona la réplica de Cloud SQL en el menú desplegable Instancia.
3. Selecciona el archivo de registro replication-setup.log.

Si la réplica de Cloud SQL no puede conectarse al servidor externo, comprueba lo siguiente:

• Cualquier cortafuegos del servidor externo está configurado para permitir conexiones desde la dirección IP de salida de la réplica de Cloud SQL.
• La configuración de SSL/TLS es correcta.
• El usuario, el host y la contraseña de la réplica son correctos.

Siguientes pasos

• Consulta cómo actualizar una instancia.
• Consulta información sobre cómo gestionar réplicas.
• Consulta información sobre cómo monitorizar instancias.
• Consulta cómo promocionar tu réplica de Cloud SQL para convertirla en una instancia independiente y dejar de replicar desde el servidor externo.