Migrar para um novo cluster de destino

Nesta página, descrevemos como migrar seus bancos de dados para um novo cluster do AlloyDB 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 um cluster do AlloyDB para PostgreSQL.

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

  1. Configure o banco de dados de origem para permitir que o Database Migration Service replique seus dados para os novos bancos de dados.
  2. Crie o perfil de conexão de origem.
  3. Criar o job de migração contínua e configurar o novo cluster de destino do AlloyDB para PostgreSQL.
  4. Inicie e monitore o job contínuo de migração.
  5. Promova o job de migração, audite as permissões e redirecione o tráfego do aplicativo para o novo cluster.

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 outros limites operacionais. O Database Migration Service para AlloyDB para PostgreSQL é compatível com migrações contínuas.

    • Diferentes métodos de conectividade de rede estão disponíveis para diferentes bancos de dados de origem. 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 um novo cluster 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 o cluster de destino diretamente no AlloyDB para PostgreSQL (consulte Guia: migrar para um cluster atual do AlloyDB para PostgreSQL).

  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, jobs de migração e clusters de destino) precisam residir em uma única região do Google Cloud .
  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, AlloyDB para PostgreSQL e API Compute Engine.

    Ativar as APIs

Funções exigidas

Para receber as permissões necessárias para realizar migrações homogêneas do PostgreSQL para o AlloyDB para 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 para o AlloyDB para 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 para o AlloyDB para PostgreSQL com o Database Migration Service:

  • datamigration.*
  • alloydb.clusters.create
  • alloydb.clusters.get
  • alloydb.clusters.list
  • alloydb.clusters.update
  • alloydb.clusters.delete
  • alloydb.instances.create
  • alloydb.instances.get
  • alloydb.instances.list
  • alloydb.instances.update
  • alloydb.instances.delete
  • alloydb.operations.get
  • alloydb.users.list
  • alloydb.users.get
  • alloydb.users.create
  • alloydb.users.update
  • alloydb.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 o banco de 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 o cluster de destino, talvez seja necessário adicionar o endereço IP de saída do AlloyDB para PostgreSQL à 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 envolve 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 de migração e configure pg_hba.conf para permitir conexões de entrada.

    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 o cluster 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 e a integridade do cluster 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 tráfego do aplicativo para o novo cluster do AlloyDB para PostgreSQL, conclua a migração seguindo estas etapas:

  1. Interrompa todas as operações de gravação no banco de dados de origem. É possível definir o banco de dados de origem como modo somente leitura para manter a funcionalidade de consulta durante a janela de transição.
  2. Promova o job de migração. A promoção do job de migração conclui a replicação de todos os eventos de CDC restantes, interrompe o fluxo de replicação e estabelece o cluster de destino do AlloyDB para PostgreSQL como um cluster principal independente e totalmente operacional.
  3. Opcional: verifique se os dados de migração estão completos e consistentes.

A seguir

Saiba mais sobre a arquitetura, os recursos e o gerenciamento do AlloyDB para PostgreSQL. Consulte Visão geral do AlloyDB para PostgreSQL.