Usar um arquivo dump para configurar a replicação de bancos de dados externos

Esta página descreve o processo de configuração da replicação quando você tem um arquivo dump criado a partir do servidor externo.

É necessário concluir todas as etapas nesta página. Quando terminar, você pode administrar e monitorar a instância de representação de origem da mesma maneira que faria com qualquer outra instância do Cloud SQL.

Antes de começar

Antes de começar, configure o servidor externo, crie a instância de representação de origem e configure o Cloud SQL réplica.

Atualizar permissões para o usuário da replicação

O usuário de replicação no servidor externo está configurado para aceitar conexões de qualquer host (%). Atualize essa conta de usuário para que ela seja usada somente com a réplica do Cloud SQL. Abra um terminal no servidor externo e digite estes 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 as configurações de replicação

Após a conclusão da configuração, verifique se a réplica do Cloud SQL pode ser replicada do servidor externo.

Primeiro, verifique se as configurações de sincronização externa estão corretas. Para fazer isso, use os comandos abaixo para verificar:

• Conectividade entre a réplica do Cloud SQL e o servidor externo
• Privilégios de usuário de replicação
• Compatibilidade de versões
• A réplica do Cloud SQL ainda não está replicando
• Os registros binários estão ativados no servidor externo
• Um identificador global de transação (GTID, na sigla em inglês) está ativado.

Abra um terminal e digite estes comandos para verificar se as configurações de sincronização externa estão corretas:

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 seu banco de dados para um bucket do Cloud Storage

É possível preencher uma réplica do Cloud SQL com um arquivo mysqldump localizado em um bucket do Cloud Storage. Essas condições se aplicam:

• Use o utilitário mysqldump que acompanha o MySQL.
• Enquanto mysqldump estiver em execução, não execute nenhuma operação DDL no servidor externo. Caso contrário, poderá haver inconsistências no arquivo de exportação.

Para exportar seu banco de dados para um bucket do Cloud Storage, siga estas etapas:

1. No Google Cloud, crie um bucket do Cloud Storage.
2. Abra um terminal usando um cliente que se conecta ao servidor de banco de dados externo e execute o comando a seguir.

    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 \
        | gsutil 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 \
        | gsutil cp - gs://replica-bucket/external-database.sql.gz

Atualize a instância de representação de origem com o caminho do arquivo do bucket do Cloud Storage

A instância de representação de origem é uma instância do Cloud SQL que representa o servidor do banco de dados de origem para a réplica do Cloud SQL. Ela é visível no console do Google Cloud e aparece da mesma forma que uma instância normal do Cloud SQL, mas não contém dados, não requer configuração ou manutenção e não afeta o faturamento.

O arquivo source.json contém informações sobre a instância de representação de origem.

{
  "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"
}

Depois de configurar a réplica do Cloud SQL, você precisa atualizar sua instância de representação de origem com o caminho do arquivo do bucket do 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 replicação no servidor externo

Depois de verificar se é possível replicar usando o servidor externo, você estará pronto para executar a replicação.

Durante o processo de importação inicial, não execute nenhuma operação DDL no servidor externo. Isso pode causar inconsistências durante a importação. Após a conclusão do processo de importação, a réplica usará os registros binários no servidor externo para alcançar o estado atual desse servidor.

Abra um terminal, faça login usando gcloud e digite o comando curl para replicar a partir do 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

Limpar o armazenamento

Se você tiver replicado com um arquivo em um bucket, remova esse arquivo e o bucket. Consulte a documentação do Cloud Storage referente a exclusão de objetos e exclusão de buckets.

Continuar a replicação

Depois de iniciar a replicação a partir do servidor externo, é necessário monitorar a replicação e concluir a migração. Para saber mais, consulte Como monitorar a replicação.

Resolver problemas

Analisar os registros de replicação

Ao verificar as configurações de replicação, os registros são gerados.

Para visualizar esses registros, siga estas etapas:

1. Acesse o visualizador de registros no console do Google Cloud:

   Acessar o Visualizador de registros

2. Selecione a réplica do Cloud SQL na lista suspensa Instância.
3. Selecione o arquivo de registro replication-setup.log.

Se a réplica do Cloud SQL não conseguir se conectar ao servidor externo, confirme o seguinte:

• Qualquer firewall no servidor do banco de dados de origem é configurado para permitir conexões usando o endereço IP de saída da réplica do Cloud SQL.
• Sua configuração SSL/TLS está correta.
• Seu usuário, host e senha de replicação estão corretos.

A seguir

• Saiba mais sobre como atualizar uma instância.
• Saiba mais sobre o gerenciamento de réplicas.
• Saiba mais sobre como monitorar instâncias.
• Saiba como promover sua réplica do Cloud SQL para promover a réplica a uma instância independente e parar de replicar do servidor externo.