Migrar para uma nova instância de destino

Nesta página, descrevemos como migrar seus bancos de dados para uma nova instância do Cloud SQL para PostgreSQL que o Database Migration Service cria em seu nome quando você configura o job de migração. Se a migração tiver requisitos diferentes, siga um fluxo de migração diferente. Para mais informações, consulte Guia: migrar para uma instância atual do Cloud SQL.

Em geral, a migração segue estas etapas:

  1. Configure o banco de dados de origem para permitir que o Database Migration Service mova seus dados para os novos bancos de dados.
  2. Crie o perfil de conexão de origem e o job de migração.
  3. Dependendo da configuração de conectividade, talvez seja necessário ajustar as configurações de firewall.
  4. Inicie e monitore o job de migração.
  5. Promova o job de migração e mova o aplicativo para usar os novos bancos de dados.

Custos

Neste documento, você usará os seguintes componentes faturáveis do Google Cloud:

Para gerar uma estimativa de custo baseada na projeção de uso deste tutorial, use a calculadora de preços.

Antes de começar

  1. Verifique se esse caminho de migração é totalmente compatível com seu cenário. Consulte as seguintes páginas:
    • Origens e destinos compatíveis na página Visão geral do cenário lista todas as versões de origem e destino compatíveis.
    • Limitações conhecidas descreve os tipos de dados compatíveis, os tamanhos de banco de dados e outras limitações.

    • Diferentes métodos de conectividade de rede estão disponíveis para diferentes bancos de dados de origem. Considere e planeje sua conectividade de rede antes de iniciar os procedimentos de migração. Para mais informações, consulte Visão geral de rede.

      A migração para uma nova instância de destino não oferece suporte à conectividade de interfaces do Private Service Connect. Se você quiser usar a conectividade das interfaces do Private Service Connect, considere pré-criar sua instância de destino diretamente no Cloud SQL. Consulte Guia: migrar para uma instância atual do Cloud SQL.

  2. Considere em qual região você quer criar o banco de dados de destino. O Database Migration Service é um produto totalmente regional, o que significa que todas as entidades relacionadas à migração (perfis de conexão de origem e destino, jobs de migração, bancos de dados de destino, espaços de trabalho de conversão) precisam ser salvas em uma única região.
  3. No console do Google Cloud , na página do seletor de projetos, selecione ou crie um projeto do Google Cloud .

    Acessar o seletor de projetos

  4. Ative as APIs Database Migration Service e API Cloud SQL Admin.

    Ative as APIs

Funções exigidas

Para receber as permissões necessárias para realizar migrações homogêneas do PostgreSQL com o Database Migration Service, peça ao administrador para conceder a você os papéis do IAM necessários no projeto:

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso na documentação do Identity and Access Management.

Esses papéis predefinidos contêm as permissões necessárias para realizar migrações homogêneas do PostgreSQL com o Database Migration Service. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para realizar migrações homogêneas do PostgreSQL com o Database Migration Service:

  • datamigration.*
  • cloudsql.instances.create
  • cloudsql.instances.get
  • cloudsql.instances.list
  • cloudsql.instances.update
  • cloudsql.instances.delete
  • cloudsql.operations.get
  • cloudsql.users.list
  • cloudsql.users.get
  • cloudsql.users.create
  • cloudsql.users.update
  • cloudsql.users.delete

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Preparar o banco de dados de origem

Para preparar os dados de origem para migração, siga estas etapas:

  1. Escolha e configure o método de conectividade de rede de origem.

    Para conectividade de lista de permissões de IP público: depois que o Database Migration Service criar a instância de destino, talvez seja necessário adicionar o endereço IP público do Cloud SQL à lista de permissões do firewall. Consulte o administrador da rede para saber como programar essas mudanças de configuração.

  2. Configure a instância do banco de dados de origem. Em geral, isso inclui as seguintes etapas:
    1. Instale a extensão pglogical do PostgreSQL (versão 2.2.1 ou mais recente) no banco de dados de origem e em todos os bancos de dados que serão migrados.
    2. Configure os parâmetros do PostgreSQL: defina wal_level = logical e garanta valores adequados para max_replication_slots, max_wal_senders e max_worker_processes.
    3. Conceda privilégios de replicação ao usuário da migração e configure pg_hba.conf para permitir conexões da instância de destino do Cloud SQL.

    Para instruções detalhadas, consulte Configurar o banco de dados de origem.

  3. Crie o perfil de conexão de origem.

Criar e executar o job de migração

Para configurar e executar a migração, siga estas etapas:

  1. Opcional: se você quiser gerenciar suas próprias chaves de criptografia para a instância de destino, prepare as chaves de criptografia gerenciadas pelo cliente (CMEK).
  2. Crie e execute o job de migração.

    É possível monitorar o progresso da migração, bem como a integridade da instância de destino, com os recursos de observabilidade do Database Migration Service. Consulte Métricas de job de migração.

Finalizar a migração

Quando você decidir mudar o aplicativo para a nova instância do Cloud SQL para PostgreSQL, conclua a migração seguindo estas etapas:

  1. Opcional: Configure réplicas de leitura em cascata. Se você quiser usar réplicas de leitura em cascata, configure-as quando o job de migração entrar na fase de CDC.
  2. Interrompa todas as operações de gravação no banco de dados de origem. É possível alternar para o modo somente leitura para manter a funcionalidade operacional.
  3. Promova o job de migração.
  4. Opcional: verifique se os dados de migração estão completos.

A seguir

Saiba mais sobre os recursos do Google Cloud para o Cloud SQL para PostgreSQL. Consulte Recursos do Cloud SQL para PostgreSQL.