Criar um job de migração para uma instância de destino atual

MySQL   |  PostgreSQL   |  PostgreSQL para AlloyDB

Visão geral

O Database Migration Service usa jobs de migração para migrar dados da instância de banco de dados de origem para a instância de destino.

A criação de um job de migração para uma instância de destino atual inclui:

• Como definir as configurações do job de migração
• Como selecionar o perfil de conexão do banco de dados de origem
• Como selecionar a instância de destino do banco de dados
• Rebaixar a instância atual para convertê-la em uma réplica de leitura
• Configurar a conectividade entre as instâncias de banco de dados de origem e de destino
• Testar o job de migração para garantir que as informações de conexão fornecidas para o job sejam válidas.

É preciso considerar algumas limitações quando você quiser migrar para uma instância de destino criada fora do Database Migration Service. Por exemplo, a instância de destino do Cloud SQL precisa estar vazia ou conter apenas dados de configuração do sistema. Saiba mais em Limitações conhecidas.

O assistente do Database Migration Service ajuda a criar um job de migração. Este assistente consiste nos seguintes painéis: Primeiros passos, Definir uma origem, Criar um destino, Definir o método de conectividade, Configurar bancos de dados de migração e Testar e criar job de migração. As informações sobre como preencher cada painel são fornecidas nas seções a seguir desta página.

Criar um job de migração usando o console Google Cloud

Para pausar a criação de um job de migração, clique em Salvar e sair. Todos os dados que foram preenchidos até esse ponto são salvos em um job de migração de rascunho, que pode ser acessado na guia Rascunhos.

Para concluir a criação de um job de migração, navegue até a guia e clique nele. O fluxo de criação é retomado de onde parou. O job permanece como rascunho até que você clique em Criar ou Criar e iniciar.

Definir configurações para o job de migração

1. Acesse os Jobs de migração no console Google Cloud .

2. Clique em Criar job de migração na parte de cima da página.

3. Dê um nome ao job de migração. Escolha um nome amigável para identificar o job de migração. Não inclua informações sensíveis ou de identificação pessoal no nome do job.

4. Mantenha o ID do job de migração gerado automaticamente.

5. Selecione o mecanismo de banco de dados de origem.

6. Selecione o mecanismo de banco de dados de destino.

7. Selecione a região de destino da migração. Essa região precisa ser a mesma em que o banco de dados de destino está localizado. Depois de escolher a região de destino, essa seleção não poderá ser alterada.

   Importante: se você planeja usar o Cloud SQL para PostgreSQL Enterprise Plus, verifique se a região tem suporte para essa edição. Consulte Suporte de região do Cloud SQL para PostgreSQL Enterprise Plus.

8. Especifique o tipo de job de migração: Único (somente snapshot) ou Contínuo (snapshot + mudanças contínuas).

9. Na seção Antes de continuar, revise os pré-requisitos, clique em Abrir para conferir instruções geradas automaticamente que podem ajudar a preparar seu banco de dados de origem para a migração. É melhor concluir esses pré-requisitos nesta etapa, mas é possível concluí-los a qualquer momento antes de testar ou iniciar o job de migração. Para mais informações, consulte Configurar a origem.

10. Clique em Salvar e continuar.

Especificar informações sobre o perfil de conexão de origem

1. Se você criou um perfil de conexão, selecione-o na lista de perfis de conexão existentes.

   Se você não tiver criado um perfil de conexão, clique em Criar um perfil de conexão na parte de baixo da lista suspensa e siga as mesmas etapas de Criar um perfil de conexão de origem.

2. Na seção Personalizar configurações de despejo de dados, clique em Mostrar configurações de despejo de dados.

   A velocidade do paralelismo de despejo de dados está relacionada à quantidade de carga no banco de dados de origem. Você pode usar as seguintes configurações:

   • Otimizado (recomendado): desempenho equilibrado com carga ideal no banco de dados de origem.
   • Máxima: oferece as velocidades de despejo mais altas, mas pode aumentar a carga no banco de dados de origem.
   • Mínimo: usa a menor quantidade de recursos de computação no banco de dados de origem, mas pode ter uma taxa de despejo mais lenta.

   Se você quiser usar configurações ajustadas de paralelismo de despejo de dados, aumente os parâmetros max_replication_slots, max_wal_senders e max_worker_processes no banco de dados de origem. Para verificar a configuração, execute o teste do job de migração ao final da criação do job de migração.

3. Clique em Salvar e continuar.

Selecionar a instância de destino

Para origens do Cloud SQL:se você estiver migrando de uma instância do Cloud SQL que usa uma conexão de IP particular para uma instância do Cloud SQL que usa um intervalo de IP não RFC 1918, adicione o intervalo não RFC 1918 à configuração de rede da sua instância do Cloud SQL de origem. Consulte Configurar redes autorizadas na documentação do Cloud SQL.

1. No menu Type of destination instance, selecione Existing instance.
2. Na seção Selecionar instância de destino, selecione sua instância de destino.
3. Analise as informações na seção Detalhes da instância e clique em Selecionar e continuar.
4. Para migrar para um banco de dados de destino existente, o Database Migration Service rebaixa a instância de destino e a converte em uma réplica. Para indicar que a redução pode ser realizada com segurança, na janela de confirmação, insira o identificador da instância de destino.
5. Clique em Confirmar e continuar.

Configurar a conectividade entre as instâncias de banco de dados de origem e de destino

Se você estiver reutilizando um perfil de conexão de origem que foi usado anteriormente para migrações heterogêneas (por exemplo, do Oracle para o Cloud SQL para PostgreSQL), escolha um método de conectividade nesta etapa. Esse método será usado para a migração homogênea de uma instância de banco de dados do Cloud SQL para PostgreSQL para outra. É necessário selecionar um método de conectividade porque o método de conectividade heterogênea não é relevante para esse job de migração.

1. No menu Método de conectividade, selecione um método de conectividade de rede. Esse método define como a instância do Cloud SQL recém-criada se conectará ao banco de dados de origem. Os métodos de conectividade de rede atuais incluem lista de permissões de IP, túnel SSH reverso e peering de VPC.

   • Se você selecionar o método de conectividade de rede da lista de permissões de IP, será necessário especificar o endereço IP de saída da instância de destino. Se a instância do Cloud SQL criada for de alta disponibilidade, inclua os endereços IP de saída da instância principal e secundária.

   • Se você selecionar o método de conectividade de rede do túnel SSH reverso, selecione a instância de VM do Compute Engine que vai hospedar o túnel.

     Depois de especificar a instância, o Google vai fornecer um script que executa as etapas de configuração do túnel entre os bancos de dados de origem e de destino. Você vai precisar executar o script na Google Cloud CLI.

     Execute os comandos em uma máquina que tenha conectividade com o banco de dados de origem e com o Google Cloud.

   • Se você selecionar o método de conectividade de rede de peering da VPC, selecione a rede VPC em que o banco de dados de origem está localizado. A instância do Cloud SQL será atualizada para se conectar a essa rede.
   • Saiba como configurar a conectividade.

2. Depois de selecionar o método de conectividade de rede e fornecer informações adicionais, clique em CONFIGURAR E CONTINUAR.

Configurar bancos de dados de migração

Você pode selecionar os bancos de dados que quer migrar.

1. Na lista Bancos de dados a migrar, selecione uma das seguintes opções:
   • Todos os bancos de dados: seleciona todos os bancos de dados que existem na origem.
   • Bancos de dados específicos: permite selecionar bancos de dados específicos de todos os que existem na origem.

2. Se você quiser migrar bancos de dados específicos, filtre a lista que aparece e selecione os bancos de dados que você quer que o Database Migration Service migre para o destino.

   Se a lista não aparecer e um erro de descoberta do banco de dados for exibido, clique em Recarregar. Se a descoberta do banco de dados falhar, o job migra todos os bancos de dados. Você pode continuar criando um job de migração e corrigir erros de conectividade mais tarde.

3. Clique em Salvar e continuar.

Testar e criar o job de migração

Nesta etapa final, revise o resumo das configurações do job de migração, a origem, o destino e o método de conectividade e teste a validade da configuração do job de migração. Se houver algum problema, você poderá modificar as configurações do job de migração. Nem todas as configurações podem ser editadas.

1. Clique em TEST JOB para verificar se:

   • O banco de dados de origem foi configurado corretamente com base nos pré-requisitos.
   • As instâncias de origem e destino podem se comunicar entre si.
   • Todas as atualizações necessárias de endereços IP particulares ou públicos no destino foram feitas.
   • O job de migração é válido, e as versões de origem e destino são compatíveis.

   Se o teste falhar, você pode resolver o problema na parte adequada do fluxo e voltar a fazer o teste.

   Para mais informações sobre os motivos pelos quais o teste pode falhar e como resolver problemas associados à falha do teste, consulte Como diagnosticar problemas do PostgreSQL.

   O job de migração pode ser criado mesmo que o teste falhe, mas, depois que o job é iniciado, ele pode falhar em algum momento durante a execução.

2. Clique em CRIAR E INICIAR JOB para criar o job de migração e iniciar imediatamente ou clique em CRIAR JOB para criar o job de migração sem iniciá-lo imediatamente.

   Cuidado: se você usou o Terraform para provisionar o banco de dados de destino, pode haver uma deriva de configuração durante a execução do job de migração. Não tente aplicar novamente as configurações do Terraform antes que a migração seja concluída. Para mais informações, consulte Desvio de configuração do Terraform.

   Se o job não for iniciado no momento da criação, ele poderá ser iniciado na página Jobs de migração clicando em START.

   Independentemente de quando o job de migração for iniciado, a organização vai ser cobrada pela existência da instância de destino.

   Quando você inicia o job de migração, o Database Migration Service inicia o despejo completo, bloqueando brevemente o banco de dados de origem. Se a origem estiver no Amazon RDS ou no Amazon Aurora, o Database Migration Service também vai exigir um curto período de inatividade na gravação (aproximadamente menos de um minuto) no início da migração. Para mais informações, consulte Considerações sobre o paralelismo de resumo de dados.

3. O job de migração é adicionado à lista de jobs de migração e pode ser visualizado diretamente.

4. Prossiga para Revisar o job de migração.

Criar um job de migração usando a Google Cloud CLI

Ao migrar para uma instância usando a Google Cloud CLI, é necessário criar manualmente o perfil de conexão para a instância de destino. Isso não é necessário quando você usa o Google Cloud console, porque o Database Migration Service cria e remove o perfil de conexão de destino para você.

Antes de começar

Antes de usar a CLI gcloud para criar um job de migração para uma instância de banco de dados de destino existente, verifique se você:

• Crie a instância de banco de dados de destino.
• Prepare a instância do banco de dados de origem. Consulte:
  • Configurar a fonte
  • Crie o perfil de conexão de origem. O identificador do perfil de conexão de origem é necessário para criar um job de migração.
  • Configurar a conectividade

Criar perfil de conexão de destino

Crie o perfil de conexão de destino para a instância de destino atual executando o comando gcloud database-migration connection-profiles create:

Este exemplo usa a flag --no-async opcional para que todas as operações sejam realizadas de forma síncrona. Isso significa que alguns comandos podem levar um tempo para serem concluídos. Você pode pular a flag --no-async para executar comandos de forma assíncrona. Se você fizer isso, use o comando gcloud database-migration operations describe para verificar se a operação foi bem-sucedida.

Antes de usar os dados do comando abaixo, faça estas substituições:

• CONNECTION_PROFILE_ID com um identificador legível por máquina para seu perfil de conexão.
• REGION pelo identificador da região em que você quer salvar o perfil de conexão.
• DESTINATION_INSTANCE_ID pelo identificador da instância de destino.
• (Opcional) CONNECTION_PROFILE_NAME com um nome legível para humanos do seu perfil de conexão. Esse valor é mostrado no console Google Cloud .

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration connection-profiles \
create postgresql CONNECTION_PROFILE_ID \
  --no-async \
  --cloudsql-instance=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration connection-profiles `
create postgresql CONNECTION_PROFILE_ID `
  --no-async `
  --cloudsql-instance=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration connection-profiles ^
create postgresql CONNECTION_PROFILE_ID ^
  --no-async ^
  --cloudsql-instance=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

Você receberá uma resposta semelhante a esta:

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

Criar o job de migração

Observação: os exemplos a seguir representam um cenário de migração em que você usa a conectividade de IP particular entre os bancos de dados de origem e de destino. Se você usar um tipo de conectividade diferente (por exemplo, peering de VPC ou um túnel SSH reverso), adicione as flags necessárias, como --peer-vpc ou --vm, --vm-ip, --vm-port, --vpc. Para mais informações, consulte Configurar a conectividade e Exemplos da Google Cloud CLI.

Observação: somente o tipo de migração contínua é compatível com migrações para o Database Migration Service para PostgreSQL.

Este exemplo usa a flag --no-async opcional para que todas as operações sejam realizadas de forma síncrona. Isso significa que alguns comandos podem levar um tempo para serem concluídos. Você pode pular a flag --no-async para executar comandos de forma assíncrona. Se você fizer isso, use o comando gcloud database-migration operations describe para verificar se a operação foi bem-sucedida.

Antes de usar os dados do comando abaixo, faça estas substituições:

• MIGRATION_JOB_ID com um identificador legível por máquina para o job de migração. Use esse valor para trabalhar com jobs de migração usando comandos da CLI do Google Cloud ou a API do Database Migration Service.
• REGION pelo identificador da região em que você quer salvar o job de migração.
• MIGRATION_JOB_NAME com um nome legível para humanos para o job de migração. Esse valor é exibido no Database Migration Service no console Google Cloud .
• SOURCE_CONNECTION_PROFILE_ID com um identificador legível por máquina do perfil de conexão de origem.
• DESTINATION_CONNECTION_PROFILE_ID com um identificador legível por máquina do perfil de conexão de destino.

• Opcional: o Database Migration Service migra todos os bancos de dados na sua origem por padrão. Se você quiser migrar apenas bancos de dados específicos, use a flag --databases-filter e especifique os identificadores como uma lista separada por vírgulas.

  Por exemplo: --databases-filter=my-business-database,my-other-database

  É possível editar os jobs de migração criados com o --database-filter flag usando o comando gcloud database-migration migration-jobs update.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --type=CONTINUOUS \

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --type=CONTINUOUS `

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --type=CONTINUOUS ^

Você receberá uma resposta semelhante a esta:

Waiting for migration job [MIGRATION_JOB_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created migration job MIGRATION_JOB_ID [OPERATION_ID]

Desmonte o banco de dados de destino

O Database Migration Service exige que a instância de banco de dados de destino funcione como uma réplica de leitura durante a migração. Antes de iniciar o job de migração, execute o comando gcloud database-migration migration-jobs demote-destination para rebaixar a instância do banco de dados de destino.

Antes de usar os dados do comando abaixo, faça estas substituições:

• MIGRATION_JOB_ID pelo identificador do job de migração.

  Se você não souber o identificador, use o comando gcloud database-migration migration-jobs list para listar todos os jobs de migração em uma determinada região e conferir os identificadores.

• REGION com o identificador da região em que o perfil de conexão é salvo.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration migration-jobs \
demote-destination MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration migration-jobs `
demote-destination MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration migration-jobs ^
demote-destination MIGRATION_JOB_ID ^
  --region=REGION

Resultado

A ação é realizada de forma assíncrona. Assim, esse comando retorna uma entidade de operação que representa uma operação de longa duração:

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: demote-destination
name: OPERATION_ID

Para saber se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:

• Use o comando gcloud database-migration migration-jobs describe para conferir o status do job de migração.
• Use o gcloud database-migration operations describe com o OPERATION_ID para conferir o status da operação.

Gerenciar jobs de migração

Nesse ponto, o job de migração está configurado e conectado à instância de banco de dados de destino. É possível fazer isso usando as seguintes operações:

1. Opcional: verifique o job de migração.
   Recomendamos que você verifique seu job de migração executando o comando gcloud database-migration migration-jobs verify.

   Para mais informações, abra a seção a seguir:

   gcloud database-migration migration-jobs verify

   Antes de usar os dados do comando abaixo, faça estas substituições:

   • MIGRATION_JOB_ID pelo identificador do job de migração.

     Se você não souber o identificador, use o comando gcloud database-migration migration-jobs list para listar todos os jobs de migração em uma determinada região e conferir os identificadores.

   • REGION com o identificador da região em que o perfil de conexão é salvo.

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration migration-jobs \
   verify MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration migration-jobs `
   verify MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration migration-jobs ^
   verify MIGRATION_JOB_ID ^
     --region=REGION

   Resultado

   A ação é realizada de forma assíncrona. Assim, esse comando retorna uma entidade de operação que representa uma operação de longa duração:

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: verify
   name: OPERATION_ID
   

   Para saber se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:

   • Use o comando gcloud database-migration migration-jobs describe com o MIGRATION_JOB_ID para conferir o status do job de migração.
   • Use o comando gcloud database-migration operations describe com o OPERATION_ID para conferir o status da operação.

2. Opcional: extraia informações sobre os bancos de dados selecionados para migração.
   Ao migrar bancos de dados específicos, Database Migration Service precisa recuperar os detalhes sobre os bancos de dados selecionados para o job de migração usando a flag --database-filter.

   Antes de iniciar o job de migração, execute o comando gcloud database-migration migration-jobs fetch-source-objects.

   Para mais informações, abra a seção a seguir:

   gcloud database-migration migration-jobs fetch-source-objects

   Antes de usar os dados do comando abaixo, faça estas substituições:

   • MIGRATION_JOB_ID pelo identificador do job de migração.

     Se você não souber o identificador, use o comando gcloud database-migration migration-jobs list para listar todos os jobs de migração em uma determinada região e conferir os identificadores.

   • REGION com o identificador da região em que o perfil de conexão é salvo.

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration migration-jobs \
   fetch-source-objects MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration migration-jobs `
   fetch-source-objects MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration migration-jobs ^
   fetch-source-objects MIGRATION_JOB_ID ^
     --region=REGION

   Resultado

   O resultado será assim:

   Waiting for migration job MIGRATION_JOB_ID
   to fetch source objects with OPERATION_ID
   
   Waiting for operation OPERATION_ID to complete...done.
   
   SOURCE_OBJECT                                      STATE         PHASE              ERROR
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  NOT_SELECTED  PHASE_UNSPECIFIED
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  STOPPED       CDC                {'code': 1, 'message': 'Internal error'}
   

   Para saber se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:

   • Use o comando gcloud database-migration migration-jobs describe com o MIGRATION_JOB_ID para conferir o status do job de migração.
   • Use o comando gcloud database-migration operations describe com o OPERATION_ID para conferir o status da operação.

3. Inicie o job de migração.
   Inicie o job de migração executando o comando gcloud database-migration migration-jobs start.

   Para mais informações, abra a seção a seguir:

   gcloud database-migration migration-jobs start

   Antes de usar os dados do comando abaixo, faça estas substituições:

   • MIGRATION_JOB_ID pelo identificador do job de migração.

     Se você não souber o identificador, use o comando gcloud database-migration migration-jobs list para listar todos os jobs de migração em uma determinada região e conferir os identificadores.

   • REGION com o identificador da região em que o perfil de conexão é salvo.

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration migration-jobs \
   start MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration migration-jobs `
   start MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration migration-jobs ^
   start MIGRATION_JOB_ID ^
     --region=REGION

   Resultado

   A ação é realizada de forma assíncrona. Assim, esse comando retorna uma entidade de operação que representa uma operação de longa duração:

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: start
   name: OPERATION_ID
   

   Para saber se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:

   • Use o comando gcloud database-migration migration-jobs describe com o MIGRATION_JOB_ID para conferir o status do job de migração.
   • Use o comando gcloud database-migration operations describe com o OPERATION_ID para conferir o status da operação.

Promover o job de migração

Quando a migração chegar à fase de captura de dados alterados (CDC), você poderá promover a instância do banco de dados de destino de uma réplica de leitura para uma instância independente. Execute o comando gcloud database-migration migration-jobs promote:

Antes de usar os dados do comando abaixo, faça estas substituições:

• MIGRATION_JOB_ID pelo identificador do job de migração.

  Se você não souber o identificador, use o comando gcloud database-migration migration-jobs list para listar todos os jobs de migração em uma determinada região e conferir os identificadores.

• REGION com o identificador da região em que o perfil de conexão é salvo.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration migration-jobs \
promote MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration migration-jobs `
promote MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud database-migration migration-jobs ^
promote MIGRATION_JOB_ID ^
  --region=REGION

Resultado

A ação é realizada de forma assíncrona. Assim, esse comando retorna uma entidade de operação que representa uma operação de longa duração:

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

Para saber se a operação foi concluída, consulte o objeto de operação retornado ou verifique o status do job de migração:

• Use o comando gcloud database-migration migration-jobs describe com o MIGRATION_JOB_ID para conferir o status do job de migração.
• Use o comando gcloud database-migration operations describe com o OPERATION_ID para conferir o status da operação.