Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Migração com um clique para PostgreSQL público

Última atualização: Oct 12, 2026

Este tópico descreve como usar o recurso de migração com um clique do RDS PostgreSQL para migrar um banco de dados PostgreSQL público ou uma instância de outro provedor de cloud para o RDS PostgreSQL.

Contexto

O RDS PostgreSQL opera em uma Virtual Private Cloud (VPC). Por padrão, o recurso de migração com um clique permite migrar outros bancos de dados para o RDS PostgreSQL via rede privada. Para migrar um banco de dados PostgreSQL da rede pública, configure um NAT Gateway e um Elastic IP Address (EIP) associado.

Este tópico explica como configurar um NAT Gateway e associar um EIP a uma instância RDS PostgreSQL para habilitar o recurso de migração com um clique para origens na rede pública.

Essa abordagem garante a segurança da rede da instância RDS PostgreSQL e permite a migração com um clique a partir da rede pública.

Nota

Uma entrada SNAT no NAT Gateway permite que a instância RDS PostgreSQL acesse a internet. A instância não fica exposta nem fornece service por meio do NAT Gateway. Para obter mais informações sobre NAT Gateway e SNAT, consulte Use the SNAT feature of a NAT Gateway to access the internet.

Casos de uso

  • Migre um banco de dados PostgreSQL autogerenciado da internet pública para a nuvem.

  • Migre uma instância PostgreSQL de outro provedor de cloud, como Google Cloud SQL ou Amazon RDS for PostgreSQL, para o RDS PostgreSQL.

    Nota

    Outros provedores de cloud podem ter plugins personalizados para PostgreSQL. Se você encontrar um erro de incompatibilidade de plugin durante a migração, envie um ticket.

Pré-requisitos

A instância RDS PostgreSQL deve atender aos seguintes requisitos:

  • As versões principais das instâncias de origem e destino devem corresponder. Este recurso oferece suporte ao PostgreSQL 10 ou superior.

    Nota
    • Se a versão da instância de origem for anterior ao PostgreSQL 10, atualize a versão principal antes de executar a migração com um clique.

    • Se as versões principais das instâncias de origem e destino não corresponderem, a avaliação de viabilidade falhará e a migração não poderá prosseguir.

  • A instância de destino deve ser uma instância primária; instâncias somente leitura não são suportadas.

  • O tipo de armazenamento da instância de destino deve ser disco em nuvem.

  • A instância de destino deve estar vazia. O espaço de armazenamento disponível deve ser maior ou igual ao tamanho total dos dados da instância de origem.

    Nota

    Se a instância de destino contiver dados, a avaliação de viabilidade falhará e a migração não poderá continuar. Faça backup dos dados e limpe a instância ou adquira uma nova instância.

Limitações

Nenhuma.

Impactos

Nenhum.

Precauções

Durante a tarefa de migração, garanta que a instância de origem esteja acessível. Não execute operações como reiniciar a instância. Se a instância de origem sofrer uma interrupção temporária de conexão ou um failover de alta disponibilidade (HA), a tarefa de migração falhará.

Faturamento

Configurar um NAT Gateway e associar um Elastic IP Address (EIP) gera custos. Para mais detalhes, consulte NAT Gateway billing.

Procedimento

Etapa 1: Configurar um NAT Gateway e EIP

Nesta etapa, associe um endereço IP público à VPC da instância RDS PostgreSQL. Isso permite que a instância RDS PostgreSQL acesse um banco de dados autogerenciado ou de outro provedor de cloud que possua um endereço IP público.

Importante

Antes de começar, certifique-se de que não há nenhum NAT Gateway configurado para a VPC onde a instância RDS reside e que nenhum outro endereço IP público esteja associado a essa VPC. Caso contrário, poderão ocorrer problemas de conectividade.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância RDS e clique em no ID da instância.

  2. No painel de navegação à esquerda, clique em Database Connection e, depois, clique em no link da VPC exibido ao lado de Network Type.

  3. No console VPC, selecione a aba Resource Management. Na seção Public Access Service, clique em Create Now.

  4. Na página de criação do NAT Gateway, configure os parâmetros principais abaixo e mantenha os valores padrão para os demais.

    Parâmetro

    Descrição

    Exemplo

    Elastic IP Address

    Se você já possui um Elastic IP Address, pode selecioná-lo. Para este exemplo, escolha Purchase Elastic IP Address.

    Purchase Elastic IP Address

    Peak Bandwidth

    Defina a largura de banda máxima conforme sua necessidade. Nesta migração com um clique, recomenda-se definir a largura de banda de pico no valor máximo para evitar lentidão causada por limites de banda.

    200 Mbps

  5. Clique em Buy Now.

  6. Verifique se as configurações estão corretas, marque a caixa de termos de service e clique em Confirm Order.

    Após a conclusão da operação, o NAT Gateway será criado, um EIP será associado a ele e uma entrada SNAT será configurada.

  7. Clique em no ID do recurso Elastic IP Address. Na página Instance Information do EIP, visualize o IP Address público.

Etapa 2: Configurar o banco de dados de origem

Banco de dados PostgreSQL autogerenciado

  1. Configure the postgresql.conf file.

  2. Create a migration account.

  3. Update the pg_hba.conf file.

    Importante

    O endereço IP configurado no arquivo pg_hba.conf corresponde ao Elastic IP Address/32 associado à instância RDS PostgreSQL na Step 1.

  4. Configure the server firewall.

PostgreSQL de outros provedores

  1. Modifique o valor do parâmetro wal_keep_segments ou wal_keep_size. Para mais informações, consulte a documentação oficial do provedor de cloud.

    Essa configuração garante que arquivos de log anteriores suficientes sejam mantidos no diretório pg_wal. Isso impede que a instância de origem exclua logs WAL necessários após um backup completo, o que forçaria o reinício da migração.

    • wal_keep_segments: Aplicável ao PostgreSQL 10, 11 e 12. Recomenda-se definir este parâmetro como 4096 ou superior.

    • wal_keep_size: Aplicável ao PostgreSQL 13, 14 e 15. Recomenda-se definir este parâmetro como 65536 ou superior.

  2. Crie uma conta de migração.

    CREATE USER migratetest CREATEROLE REPLICATION LOGIN PASSWORD '123456';
    GRANT pg_monitor TO migratetest;
    Nota

    A conta (migratetest) e a senha (123456) no comando acima são apenas exemplos. Modifique-as conforme suas necessidades.

  3. Habilite conexões de rede pública e configure o grupo de segurança ou lista de permissões para permitir acesso a partir do Elastic IP Address definido na Step 1. Para mais detalhes, consulte a documentação oficial do provedor de cloud.

    Importante

    Certifique-se de que o protocolo ICMP esteja habilitado para a instância PostgreSQL do outro provedor de cloud. Execute o comando ping <public endpoint of the PostgreSQL instance> para verificar a conectividade.

Etapa 3: Executar uma avaliação de viabilidade

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância RDS e clique em no ID da instância.

  2. No painel de navegação à esquerda, escolha Cloud Migration/DR Deployment. Depois, clique em na aba Feasibility Assessment.

  3. Na etapa Configure Scenario and Source Type do assistente de configuração, selecione Migration to Cloud para o cenário e Self-managed Instance or Other Instance para o tipo de origem. Em seguida, clique em Next.

  4. Na etapa Configure Destination Instance, clique em Next.

  5. Na etapa Configure Source Instance, selecione todas as opções e clique em Next.

  6. Na etapa Start Feasibility Assessment, defina os seguintes parâmetros.

    Parâmetro

    Descrição

    Migration Task Name

    O sistema gera um nome automaticamente. Nenhuma modificação é necessária.

    Source VPC/DNS IP

    • Para um banco de dados PostgreSQL autogerenciado na rede pública: o endereço IP público do servidor de banco de dados.

    • Para uma instância PostgreSQL de outro provedor de cloud: o endpoint público da instância.

    Port of Source Instance

    • Para um banco de dados PostgreSQL autogerenciado na rede pública: a porta do banco de dados. Execute o comando netstat -a | grep PGSQL para visualizar a porta.

    • Para uma instância PostgreSQL de outro provedor de cloud: localize essa informação no console de gerenciamento do provedor.

    Username

    O nome de usuário e a senha da conta de migração criada na Step 2.

    Password

  7. Clique em Create Feasibility Assessment Task.

    Após a conclusão da avaliação de migração, visualize o status da tarefa na lista Migration to Cloud, na página Feasibility Assessment.

    • Prossiga com a Migration to Cloud somente se o Status for Successful.

    • Se o Status for Failed, clique em View Report na coluna Actions e resolva o problema com base na mensagem de erro. Para informações sobre erros comuns, consulte Interpret the migration assessment report.

      Nota

      Outros provedores de cloud podem ter plugins personalizados para PostgreSQL. Se você encontrar um erro de incompatibilidade de plugin durante a migração, envie um ticket.

    Após corrigir os erros, clique em Re-assess na coluna Actions para executar a avaliação novamente.

Etapa 4: Migrar para a nuvem

Importante

Execute esta etapa somente após o sucesso da tarefa de avaliação de viabilidade.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância RDS e clique em no ID da instância.

  2. No painel de navegação à esquerda, escolha Cloud Migration/DR Deployment, mude para a aba Migration to Cloud e clique em Create Migration to Cloud Task.

  3. Na janela Create Cloud Migration Task, selecione a tarefa bem-sucedida da Step 3 na lista suspensa Associated Assessment Task.

    Ao selecionar uma Associated Assessment Task, os demais parâmetros são preenchidos automaticamente.

  4. Clique em Initiate Migration to Cloud para iniciar a tarefa de migração.

    Aviso

    Durante a tarefa de migração, garanta que a instância de origem esteja acessível. Não execute operações como reiniciar a instância. Se a instância de origem sofrer uma interrupção temporária de conexão ou um failover de alta disponibilidade (HA), a tarefa de migração falhará.

  5. Realize o cutover.

    1. Na lista de tarefas de migração, clique em no link na coluna Cloud Migration Phase para acompanhar o progresso da tarefa.

    2. Quando a fase de migração for Incremental Data Synchronization, clique em Switchover na coluna Actions para promover a instância RDS PostgreSQL a instância primária e começar a atender ao tráfego de produção.

    3. Na janela Switchover, siga as instruções na tela para definir a instância de origem como somente leitura ou interromper as gravações de seus aplicativos.

      Para definir a instância de origem como somente leitura:

      -- Set the database to read-only.
      ALTER SYSTEM SET default_transaction_read_only=on;
      -- Reload the parameter configuration to apply the change.
      SELECT pg_reload_conf();
      -- Terminate all existing sessions.
      SELECT pg_terminate_backend(pid) FROM pg_stat_activity 
      WHERE usename not in ('replicator', 'monitor', 'pgsql', 'aurora') AND pid != pg_backend_pid();
    4. Marque todas as caixas de seleção e clique em Switch Now. Aguarde a conclusão da migração.