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 de destino do Cloud SQL.

Observação: para conectividade IP, ao migrar para uma instância do Cloud SQL criada com o Database Migration Service, só é possível usar o método de acesso a serviços particulares (peering de VPC). Se você quiser usar o Private Service Connect com o cluster de destino, primeiro crie a instância de destino diretamente no Cloud SQL, e siga as etapas na página Migrar para uma instância atual.

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

• 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 de banco de dados de destino do Cloud SQL 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 a criar um job de migração. O assistente consiste em vários painéis em que você fornece informações sobre seus bancos de dados de origem, bancos de dados de destino e 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 Google Cloud console.
2. Clique em Criar job de migração na parte de cima da página.

3. Forneça um nome para o job de migração.

   Escolha um nome amigável que ajude 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 de banco de dados de origem.

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

7. Selecione a região de destino para sua migração. É aqui que a instância do Database Migration Service é criada e precisa 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, 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 é compatível com essa edição. Consulte Suporte de região do Cloud SQL para PostgreSQL Enterprise Plus.

8. Especifique o tipo de serviço 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 de destino do Cloud SQL. É 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.

   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 de a lista suspensa. Depois 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. É possível usar as seguintes configurações:

   • Ideal (recomendado): desempenho equilibrado com carga ideal no banco de dados de origem.
   • Máximo: oferece as maiores velocidades de despejo, mas pode causar aumento da 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 capacidade de processamento de despejo mais lenta.

   Se você quiser usar configurações de paralelismo de despejo de dados ajustadas, aumente os parâmetros max_replication_slots, max_wal_senders, e max_worker_processes no banco de dados de origem. É possível verificar a configuração executando o teste do job de migração no 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 por IP particular para uma instância do Cloud SQL que usa um intervalo de IP de endereço não RFC 1918, adicione o intervalo não RFC 1918 à configuração de rede da 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 apropriado (por exemplo, nos arquivos de registro).

3. Forneça 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 compatíveis do Database Migration Service para 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 e Cloud SQL para PostgreSQL Enterprise Plus.

   As edições do Cloud SQL para PostgreSQL vêm com diferentes conjuntos de recursos, tipos de máquinas 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 selecionada ao definir as configurações do job de migração. Selecione uma zona nessa 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 primária 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 primária 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 zonas diferentes.

7. Escolha se quer se conectar a essa instância com um endereço IP particular ou público.
1. Se você planeja se conectar com peering de VPC ou túnel SSH reverso, marque a caixa de seleção IP particular.
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 Google Cloud console.
• Você tem a servicenetworking.services.addPeering permissão do IAM.
• Você configurou 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 no seu projeto ou uma rede VPC compartilhada.
• 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
  • Conceder ao usuário o papel de compute.networkAdmin do IAM no projeto host
2. Selecione a rede VPC associada para fazer o peering. Se você planeja se conectar à origem da migração com 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, é possível 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 com a lista de permissões de IP, selecione IP público.

   Opcionalmente, clique em Redes autorizadas e autorize uma rede ou um proxy para se conectar à instância do Cloud SQL. As instâncias do Cloud SQL aceitam conexões apenas de endereços autorizados. Para mais informações sobre como configurar o acesso público à instância, consulte Configurar o IP público.

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 PostgreSQL tipos de máquinas.

9. Para o Cloud SQL para PostgreSQL Enterprise Plus: marque 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 do Cloud SQL para PostgreSQL Enterprise Plus que adiciona uma unidade de estado sólido local de alta velocidade ao banco de dados de destino. Esse recurso pode gerar custos adicionais para o Cloud SQL. Para mais informações sobre o cache de dados, consulte Visão geral do cache de dados em documentação do Cloud SQL.

10. Especifique o tipo de armazenamento da instância do Cloud SQL. É possível 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: verifique 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 é possível diminuí-la.
12. Opcionalmente, clique em MOSTRAR CONFIGURAÇÕES OPCIONAIS e faça o seguinte:

    1. Especifique se você quer gerenciar a criptografia dos dados migrados da origem para o destino. Por padrão, os dados são criptografados com uma chave gerenciada por 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 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 da chave e clicar em SALVAR.

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

       Se o Database Migration Service não tiver essas permissões, as informações vão aparecer, especificando que a conta de serviço do Database Migration Service não pode usar a CMEK. Clique em CONCEDER para dar permissões ao Database Migration Service 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 as flags necessárias que serão aplicadas ao servidor de banco de dados. Se possível, verifique se as flags de 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 quaisquer rótulos específicos da instância do Cloud SQL.

       Os rótulos ajudam a organizar as instâncias. Por exemplo, é possível organizar rótulos por centro de custos ou por 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ó estão disponíveis depois que você promove a migração.

13. Na janela Criar banco de dados de destino, clique em CRIAR DESTINO E CONTINUAR para criar a nova instância. Isso pode levar vários minutos.
    Isso vai criar uma instância do Cloud SQL para a qual você será cobrado 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 CANCELAR botão para limpar a instância do Cloud SQL. Se o navegador ou a guia for fechada, Salvar e sair for clicado ou a tela for navegada a partir dela, a instância do Cloud SQL não será limpa e precisará ser excluída manualmente na página Instâncias do Cloud SQL.
    Depois que a instância de destino for criada, as configurações da instância do Cloud SQL não poderão 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 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), nesta etapa, escolha um método de conectividade. 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ê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 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, especifique o endereço IP de saída da instância de destino. Se a instância do Cloud SQL criada for uma instância de alta disponibilidade, inclua os endereços IP de saída da instância primária e da 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 para configurar o túnel entre os bancos de dados de origem e destino. Será necessário executar o script na Google Cloud CLI.

     Execute os comandos de 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 de 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 outras informações para o método, 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 de todos os bancos de dados 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 do banco de dados falhar, o job vai migrar todos os bancos de dados. É possível 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, da origem, do destino e do método de conectividade e 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 são editáveis.

1. Clique em TESTAR 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.
   • Todas as atualizações de endereços IP particulares ou públicos necessárias no destino são 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 apropriada do fluxo e refazer o teste.

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

   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 o job de migração e iniciá-lo 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 INICIAR.

   Independentemente de quando o job de migração for iniciado, sua organização será cobrada 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 exigirá um período curto de inatividade na gravação (aproximadamente menos de um minuto) 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.