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 de migração para migrar dados da instância de banco de dados de origem para a instância de destino do Cloud SQL.

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

• Como definir configurações para o job de migração
• Como especificar informações sobre o perfil de conexão que você criou para o banco de dados de origem (perfil de conexão de origem)
• Como definir configurações e criar a instância de destino do banco de dados do Cloud SQL
• 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.

O Database Migration Service vem com um assistente para ajudar você a criar um job de migração. Este assistente tem cinco painéis: Primeiros passos, Definir uma origem, Criar um destino, Definir o método de conectividade e Testar e criar o job de migração. As informações sobre como preencher cada painel são fornecidas nas diversas seções desta página.

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

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 a página 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 para a migração. É aqui que a instância do Database Migration Service é criada e precisa ser selecionada com base no local 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, 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. 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 do Cloud SQL de destino. É 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 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.

Definir e criar a instância de destino do Cloud SQL

Observação: 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 de origem do Cloud SQL. Consulte Configurar redes autorizadas na documentação do Cloud SQL.

1. No menu suspenso Tipo de instância de destino, selecione Nova instância.

   Também é possível migrar para uma instância atual. Consulte Job de migração para uma instância atual.

2. Forneça um ID para a instância do Cloud SQL ou use o ID gerado automaticamente. Não inclua informações sensíveis ou de identificação pessoal no ID. Elas são visíveis externamente. Não é necessário incluir o ID do projeto no nome da instância. Isso é feito automaticamente quando necessário, como nos arquivos de registro.

3. Informe uma senha alfanumérica para a instância de destino do Cloud SQL. Essa será a senha da conta de administrador postgres na instância.

   Insira a senha manualmente ou clique em Gerar para que o Database Migration Service crie uma senha automaticamente.

4. Escolha a versão do banco de dados para a instância de destino na lista de versões do Database Migration Service compatíveis com o mecanismo de banco de dados especificado. Saiba mais sobre o suporte à migração entre versões.
5. Selecione a edição do Cloud SQL para PostgreSQL para a instância de destino. Há duas opções disponíveis: Cloud SQL para PostgreSQL Enterprise Edition e Cloud SQL para PostgreSQL Enterprise Plus Edition.

   As edições do Cloud SQL para PostgreSQL vêm com diferentes conjuntos de recursos, tipos de máquina disponíveis e preços. Consulte a documentação do Cloud SQL para escolher a edição adequada às suas necessidades. Confira mais informações em Introdução às edições do Cloud SQL para PostgreSQL.

6. A instância é criada na região que você selecionou ao definir as configurações do job de migração. Selecione uma zona dentro dessa região ou deixe a zona definida como Qualquer para que o Google selecione uma automaticamente.

   Se você estiver configurando a instância para alta disponibilidade, selecione Várias zonas (altamente disponível). É possível selecionar a zona principal e a secundária. As condições a seguir se aplicam quando a zona secundária é usada durante a criação da instância:

   • A zona padrão é Qualquer para a zona principal e Qualquer (diferente da primária) para a zona secundária.
   • Se as zonas primária e secundária forem especificadas, elas precisarão ser diferentes.

7. Escolha se você quer se conectar a essa instância por meio de um endereço IP público ou particular.
1. Se você planeja se conectar usando peering de VPC ou túnel SSH reverso, selecione a caixa de seleção IP privado.
1. Verifique se o seguinte é verdadeiro para ativar o IP particular:
• A API Service Networking está ativada. É possível ativar a API Service Networking usando o console do Google Cloud.
• Você tem a permissão servicenetworking.services.addPeering do IAM.
• Você configurou o acesso a serviços particulares para seu projeto, para o qual é necessário ter o papel do IAM compute.networkAdmin.
• Há pelo menos uma rede VPC não legada ou uma rede VPC compartilhada no seu projeto.
• Se você estiver usando uma rede VPC compartilhada, também precisará fazer o seguinte:
  • Ativar a API Service Networking no projeto host
  • Adicionar o usuário ao projeto host
  • Conceda ao usuário o papel de IAM compute.networkAdmin no projeto host.
2. Selecione a rede VPC associada ao par. Se você planeja se conectar à origem da migração usando o peering de VPC, escolha a VPC em que a instância está localizada.
3. Se uma rede de serviço gerenciado nunca foi configurada para a VPC selecionada, você pode selecionar um intervalo de IP e clicar em Conectar ou usar um intervalo de IP selecionado automaticamente e clicar em Alocar e conectar.
2. Se você planeja se conectar usando a lista de permissões de IP, marque a caixa de seleção IP público.

1. Se quiser, clique no campo Redes autorizadas e autorize uma rede ou um proxy a se conectar à instância do Cloud SQL. As redes só serão autorizadas pelos endereços que você fornecer. Saiba mais sobre como configurar o acesso público à instância.

8. Selecione o tipo de máquina para a instância do Cloud SQL. O tamanho do disco precisa ser igual ou maior que o tamanho do banco de dados de origem.
   Observação: as máquinas disponíveis na seleção Tipo de máquina dependem da edição do Cloud SQL que você usa.

   Saiba mais sobre os tipos de máquina do PostgreSQL.

9. Para a edição Enterprise Plus do Cloud SQL para PostgreSQL: selecione a caixa de seleção Ativar cache de dados se quiser usar o recurso de cache de dados no banco de dados de destino.

   O cache de dados é um recurso opcional disponível para instâncias da edição Enterprise Plus do Cloud SQL para PostgreSQL que adiciona uma unidade de estado sólido local de alta velocidade ao banco de dados de destino. Esse recurso pode gerar custos adicionais no Cloud SQL. Para mais informações sobre o cache de dados, consulte Visão geral do cache de dados na documentação do Cloud SQL.

10. Especifique o tipo de armazenamento da instância do Cloud SQL. Você pode escolher uma unidade de estado sólido (SSD) ou uma unidade de disco rígido (HDD).
11. Especifique a capacidade de armazenamento (em GB) da instância do Cloud SQL.
    Importante: confira se a instância tem capacidade de armazenamento suficiente para processar os dados do banco de dados de origem. É possível aumentar essa capacidade a qualquer momento, mas não diminuí-la.
12. Opcionalmente, clique em MOSTRAR CONFIGURAÇÕES OPCIONAIS e:

    1. 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). Para fazer isso, siga estas etapas:

       1. Marque a caixa de seleção Usar uma chave de criptografia gerenciada pelo cliente (CMEK).
       2. No menu Selecionar uma chave gerenciada pelo cliente, selecione a CMEK.

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

       Como parte da criação do job de migração, o Database Migration Service vai verificar se a CMEK existe e se ele tem permissões para usar a chave.

       Se o Database Migration Service não tiver essas permissões, informações vão aparecer, especificando que a conta de serviço do Database Migration Service não pode usar o CMEK. Clique em CONCEDER para conceder ao Database Migration Service permissões para usar a chave.

       Para mais informações sobre como criar uma CMEK, consulte Como usar chaves de criptografia gerenciadas pelo cliente (CMEK).

    2. Adicione todas as flags necessárias que serão aplicadas ao servidor de banco de dados. Se possível, verifique se as flags do banco de dados na instância de destino do Cloud SQL criada são as mesmas do banco de dados de origem. Saiba mais sobre as flags de banco de dados compatíveis com o PostgreSQL.
    3. Adicione rótulos específicos à instância do Cloud SQL.

       Os rótulos ajudam a organizar as instâncias. Por exemplo, é possível organizar rótulos por centro de custo ou ambiente. Os rótulos também são incluídos na fatura para que você confira a distribuição de custos entre eles.

    4. Clique em CRIAR E CONTINUAR.

       A criação de réplicas de leitura e a ativação da alta disponibilidade só ficam disponíveis depois que você promove a migração.

13. Na janela Create destination database, clique em CREATE DESTINATION & CONTINUE para criar a nova instância. Isso pode levar alguns minutos.
    Isso vai criar uma instância do Cloud SQL que será cobrada de acordo com a configuração especificada. Se o fluxo de criação do job de migração for encerrado antes da conclusão, use o botão CANCELAR para limpar a instância do Cloud SQL. Se o navegador ou a guia for fechado, se o botão Salvar e sair for clicado ou se a tela for fechada, a instância do Cloud SQL não será limpa e precisará ser excluída manualmente da página de instâncias do Cloud SQL.
    Depois que a instância de destino é criada, as configurações da instância do Cloud SQL não podem mais ser editadas no console do Database Migration Service. Ainda é possível acessar a instância diretamente no console do Cloud SQL para modificá-la.
14. Aguarde a conclusão da criação da instância de destino.

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 suspenso 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, vai precisar 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 mais sobre como configurar a conectividade.

2. Depois de selecionar o método de conectividade de rede e fornecer outras informações, clique em CONFIGURAR 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, 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 de endereços IP públicos ou particulares 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 a ele, consulte Diagnosticar problemas do PostgreSQL.

   O job de migração pode ser criado mesmo se o teste falhar, 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.

   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, sua organização será cobrada pela existência da instância de destino.

   Importante: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 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 visualizado diretamente.