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

MySQL   |  PostgreSQL   |  PostgreSQL para AlloyDB

Visão geral

O Database Migration Service usa jobs para migrar dados da instância de banco de dados de origem para a instância de banco de dados de destino do AlloyDB.

Para conectividade de IP particular, ao migrar para um cluster do AlloyDB para PostgreSQL criado com o Database Migration Service, só é possível usar o método de acesso a serviços particulares. Se você quiser usar o Private Service Connect com seu cluster de destino, primeiro crie o destino do AlloyDB para PostgreSQL fora do Database Migration Service e siga o fluxo Migrar para uma instância atual.

A criação de um job de migração inclui:

• Como definir configurações para o job de migração
• Especificar informações sobre o perfil de conexão que você criou para seu banco de dados de origem (perfil de conexão de origem)
• Definir configurações para a instância do banco de dados de destino do AlloyDB e criar a instância
• Configurar a conectividade entre as instâncias de banco de dados de origem e destino
• Testar o job de migração para garantir que as informações de conexão fornecidas para o job sejam válidas

O assistente do Database Migration Service ajuda você a criar um job de migração. O assistente consiste em vários painéis a seguir, em que você fornece as informações sobre seus bancos de dados de origem e de destino, além dos métodos de conectividade. No assistente, também é possível testar o job de migração antes de terminar de criá-lo. As informações sobre como preencher cada painel são fornecidas nas várias seções desta página.

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

1. Acesse a página Jobs de migração no consoleGoogle 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 simples que ajude você a 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 do banco de dados de origem.

6. Selecione AlloyDB para PostgreSQL como o mecanismo de destino.

7. Selecione a região de destino para sua migração. É aqui que a instância do Database Migration Service é criada. Ela deve ser selecionada com base na localização dos serviços que precisam dos seus dados, como instâncias do Compute Engine e apps do App Engine, entre outros serviços. Depois de escolher a região de destino, não é possível mudar essa seleção.

8. Escolha Contínuo (snapshot + mudanças em andamento) como o tipo de job de migração.

9. Revise os pré-requisitos necessários que são gerados automaticamente para refletir como o ambiente precisa estar preparado para um job de migração. Esses pré-requisitos podem incluir como configurar o banco de dados de origem e como conectá-lo à instância de banco de dados de destino do AlloyDB. É melhor concluir esses pré-requisitos nessa etapa, mas é possível concluí-los a qualquer momento antes de testar ou iniciar o job de migração. Para mais informações sobre esses pré-requisitos, consulte Configurar sua 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 atuais.

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

   Recomendamos criar um perfil de conexão designado para a migração do AlloyDB.

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:

   • Ideal (recomendado): performance equilibrada com carga ideal no banco de dados de origem.
   • Máximo: oferece as maiores velocidades de despejo, 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 transferência 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 sua configuração, execute o teste do job de migração ao final da criação do job.

3. Clique em Salvar e continuar.

Se o banco de dados de origem for uma instância do Cloud SQL e tiver apenas o IP público ativado, ative o IP privado antes de continuar para a próxima seção. Não se esqueça de atualizar o perfil de conexão com o IP privado.

Definir e criar a instância de destino do AlloyDB

Agora, você vai criar um novo cluster de destino do AlloyDB para seu job de migração. Os clusters são os recursos de nível superior no AlloyDB. Elas contêm uma única instância principal para acesso de leitura/gravação ao banco de dados criado durante o processo de migração.

Para criar um cluster de destino:

1. Escolha um tipo de cluster. No momento, o Database Migration Service é compatível com clusters do AlloyDB altamente disponíveis. Eles podem veicular dados de mais de uma zona em uma região, sem pools de leitura.
2. Clique em CONTINUAR.
3. Configure o cluster:
   1. No campo ID do cluster, insira um ID para o cluster.
   2. No campo Senha, insira uma senha para o usuário padrão postgres. Você vai precisar da senha para fazer login no banco de dados.
   3. No campo Rede:
      1. Selecione um caminho de rede para definir quais recursos estão disponíveis ao configurar a conectividade de migração. Os clusters só podem ser configurados com um caminho de rede IP particular. Se você planeja se conectar ao banco de dados de origem com o peering de VPC, selecione a VPC em que ele está localizado.
      2. Se a rede não estiver configurada para acesso a serviços particulares, clique em Configurar conexão e siga o assistente de configuração de conexão.
      3. Se uma rede de serviço gerenciado nunca foi configurada para a VPC selecionada, você pode escolher selecionar um intervalo de IP e clicar em Conectar ou usar um intervalo de IP selecionado automaticamente e clicar em Alocar e conectar.
   4. Opcional: na seção Criptografia, especifique se você quer gerenciar a criptografia dos dados migrados da origem para o destino. Por padrão, seus dados são criptografados com uma chave gerenciada pelo Google Cloud.

      Se você quiser gerenciar a criptografia, use uma chave de criptografia gerenciada pelo cliente (CMEK). A chave precisa estar no mesmo local que o cluster do AlloyDB. Por exemplo, clusters localizados em us-west1 só podem usar chaves em us-west1.

      1. Selecione o botão de opção Usar uma chave de criptografia gerenciada pelo cliente (CMEK).
      2. No menu Selecionar uma chave gerenciada pelo cliente, escolha sua CMEK.

      Se você não encontrar sua chave, clique em INSERIR NOME DO RECURSO DA CHAVE para fornecer o nome do recurso da chave que você quer usar. Por exemplo, é possível inserir projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key no campo Nome do recurso de chave e clicar em SALVAR.

      Ao criar o job de migração, o Database Migration Service verifica se a CMEK existe e se o serviço tem permissões para usar a chave.

      Se o Database Migration Service não tiver essas permissões, uma mensagem vai aparecer informando que a conta de serviço do Database Migration Service não pode usar a CMEK. Clique em GRANT para dar ao Database Migration Service permissões para usar a chave.

      Para mais informações sobre chaves de criptografia, consulte Usar CMEK na documentação do AlloyDB.

   5. Clique em CONTINUAR.
4. Configure a instância principal. Uma instância principal determina a capacidade de computação de um cluster e oferece suporte a operações de leitura e gravação:
1. No campo ID da instância, insira um ID para a instância principal.
2. Selecione um tipo de máquina.
3. Se você planeja usar o método de conectividade Lista de permissões de IP, marque a caixa de seleção Ativar IP público de saída.
4. Opcional: defina flags para sua instância. Você pode usar flags para personalizar a instância. Para informações sobre flags compatíveis, consulte a documentação do AlloyDB. Para cada flag:
   1. Clique em ADICIONAR FLAG.
   2. Selecione uma flag na lista Nova flag de banco de dados.
   3. Informe um valor para a flag.
   4. Clique em CONCLUÍDO.
5. Clique em Salvar e continuar.
6. Clique em CRIAR DESTINO E CONTINUAR para confirmar.
7. Aguarde a conclusão da criação da instância de destino.

Seu cluster do AlloyDB vai estar no estado "Bootstrap" enquanto for gerenciado pelo Database Migration Service. Enquanto estiver em "Inicialização", não será possível realizar operações no cluster. Se ainda quiser excluir o cluster, use o gcloud com a opção --force.

Configurar a conectividade entre as instâncias de banco de dados de origem e 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 PostgreSQL), escolha um método de conectividade nesta etapa. Esse método será usado para a migração homogênea do banco de dados do Cloud SQL para PostgreSQL para o AlloyDB. É necessário selecionar um método de conectividade porque o método heterogêneo não é relevante para esse job de migração.

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

2. Se você selecionar o método de conectividade de rede da lista de permissões de IP, especifique o endereço IP de saída da instância de destino. Copie os endereços IP de saída das instâncias primária e secundária e use-os para configurar o firewall de rede do servidor do banco de dados de origem e no arquivo pg_hba.conf, para que a origem possa aceitar conexões desses endereços.

3. Se você selecionar o método de conectividade de rede do túnel SSH reverso, escolha 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 destino. Você 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.

4. Se você selecionar o método de conectividade de rede de peering de VPC, escolha 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.

5. Se você selecionar o proxy TCP usando o método de conectividade da VM hospedada na nuvem, insira os detalhes necessários para a nova instância de VM do Compute Engine que vai hospedar o proxy TCP.

   Depois de especificar os detalhes, o console Google Cloud vai fornecer um script que executa as etapas para configurar o proxy entre os bancos de dados de origem e destino. É necessário executar o script em uma máquina com uma Google Cloud CLI atualizada.

   Depois de executar o script, ele vai gerar o IP particular da VM recém-criada. Insira o IP e clique em Configurar e continuar.

6. Saiba mais sobre como configurar a conectividade.
   Observação: se a origem for o Cloud SQL para PostgreSQL, dependendo se a instância de origem do Cloud SQL estiver na arquitetura de rede antiga ou na nova, as opções de conectividade serão limitadas a peering de VPC e proxy TCP por uma VM hospedada na nuvem.

7. Depois de selecionar o método de conectividade de rede e fornecer as informações adicionais necessárias, clique em CONFIGURAR E CONTINUAR.

Configurar bancos de dados de migração

É possível selecionar os bancos de dados que você quer migrar.

1. Na lista Bancos de dados a serem migrados, 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 entre 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 um destino.

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

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, da origem, do destino e do método de conectividade. Em seguida, teste a validade da configuração do job de migração. Se houver problemas, modifique 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 nos endereços IP privados 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 do fluxo destinada a isso e refazer o teste.

   Para mais informações sobre os motivos da falha do teste e como resolver problemas associados a ela, consulte Diagnosticar problemas do AlloyDB.

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

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

   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 INICIAR.

   Independente de quando o job de migração começar, sua organização vai receber uma cobrança pela existência da instância de destino.

   Ponto principal:quando você inicia o job de migração, o Database Migration Service começa 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 período curto (aproximadamente menos de um minuto) de inatividade na gravação no início da migração.

   Para mais informações, consulte Limitações conhecidas.

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