Use um ficheiro de despejo para configurar a replicação a partir de bases de dados externas

Esta página descreve o processo de configuração da replicação quando tem um ficheiro de despejo que criou a partir do seu servidor externo.

Tem de concluir todos os passos nesta página. Quando terminar, pode administrar e monitorizar a instância de representação de origem da mesma forma que faria com qualquer outra instância do Cloud SQL.

Antes de começar

Antes de começar, deve ter configurado o servidor externo, criado a instância de representação de origem e configurado a réplica do Cloud SQL.

Atualize as autorizações do utilizador de replicação

O utilizador da replicação no servidor externo está configurado para aceitar ligações de qualquer anfitrião (%). Deve atualizar esta conta de utilizador para que só possa ser usada com a réplica do Cloud SQL. Abra um terminal no servidor externo e introduza 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;

Valide as definições de replicação

Após a conclusão da configuração, certifique-se de que a réplica do Cloud SQL consegue replicar a partir do servidor externo.

Primeiro, certifique-se de que as definições de sincronização externa estão corretas. Para o fazer, use os comandos abaixo para validar:

• Conetividade entre a réplica do Cloud SQL e o servidor externo
• Privilégios do utilizador de replicação
• Compatibilidade de versões
• A réplica do Cloud SQL ainda não está a ser replicada
• Os registos binários estão ativados no servidor externo
• Um identificador de transação global (GTID) está ativado

Abra um terminal e introduza estes comandos para verificar se as definiçõ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

Exporte a sua base de dados para um contentor do Cloud Storage

Pode preencher uma réplica do Cloud SQL com um ficheiro mysqldump localizado num contentor do Cloud Storage. Aplicam-se as seguintes condições:

• Tem de usar o utilitário mysqldump incluído no MySQL.
• Enquanto o mysqldump estiver em execução, não realize nenhuma operação DDL no servidor externo. Esta ação pode causar inconsistências no ficheiro de exportação.

Para exportar a sua base de dados para um contentor do Cloud Storage, siga estes passos:

1. No Trusted Cloud, crie um contentor do Cloud Storage.
2. Abra um terminal com um cliente que se ligue ao servidor de base de dados externo e execute o seguinte 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

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

A instância de representação de origem é uma instância do Cloud SQL que representa o servidor de base de dados de origem para a réplica do Cloud SQL. É visível na Trusted Cloud by S3NS consola e aparece da mesma forma que uma instância normal do Cloud SQL, mas não contém dados, não requer configuração nem manutenção e não afeta a faturação.

O ficheiro 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, tem de atualizar a instância de representação de origem com o caminho do ficheiro do contentor 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

Inicie a replicação no servidor externo

Depois de confirmar que consegue replicar a partir do servidor externo, está tudo pronto para realizar a replicação.

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

Abra um terminal, inicie sessão com gcloud e, em seguida, introduza o comando curl para fazer a replicação 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

Limpe o seu armazenamento

Se fez a replicação a partir de um ficheiro num contentor, pode remover este ficheiro e o contentor. Consulte a documentação do Cloud Storage para saber como eliminar objetos e eliminar contentores.

Continuar com a replicação

Depois de iniciar a replicação a partir do servidor externo, tem de monitorizar a replicação e, em seguida, concluir a migração. Para saber mais, consulte o artigo Monitorizar a replicação.

Resolver problemas

Reveja os registos de replicação

Quando valida as definições de replicação, são gerados registos.

Pode ver estes registos através dos seguintes passos:

1. Aceda ao visualizador de registos na Trusted Cloud consola.

   Aceda ao visualizador de registos

2. Selecione a réplica do Cloud SQL no menu pendente Instância.
3. Selecione o ficheiro de registo replication-setup.log.

Se a réplica do Cloud SQL não conseguir estabelecer ligação ao servidor externo, confirme o seguinte:

• Qualquer firewall no servidor externo está configurada para permitir ligações a partir do endereço IP de saída da réplica do Cloud SQL.
• A sua configuração SSL/TLS está correta.
• O utilizador, o anfitrião e a palavra-passe da replicação estão corretos.

O que se segue?

• Saiba como atualizar uma instância.
• Saiba como gerir réplicas.
• Saiba mais sobre a monitorização de instâncias.
• Saiba como promover a sua réplica do Cloud SQL para promover a réplica a uma instância autónoma e parar a replicação a partir do servidor externo.