Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Use pg_basebackup to create a full backup for an ApsaraDB RDS for PostgreSQL instance

Última atualização: Jun 26, 2026

Use o utilitário pg_basebackup para criar um backup físico completo da sua instância do ApsaraDB RDS for PostgreSQL e exportar os arquivos de backup para sua máquina local ou instância ECS.

Pré-requisitos

Antes de começar, verifique se você:

  • Adicionou o endereço IP da sua instância ECS ou máquina local a uma lista de permissões de endereços IP da instância RDS. Para mais informações, consulte Configurar uma lista de permissões de endereços IP.

  • Instalou na sua instância ECS ou máquina local a mesma versão do PostgreSQL executada na instância RDS.

Contexto

O pg_basebackup faz backup de todos os dados de uma instância PostgreSQL no nível físico. Os arquivos de backup resultantes oferecem suporte à recuperação point-in-time (PITR).

Este tópico usa CentOS 7 e PostgreSQL 15 como exemplos.

Observações de uso

Fazer backup de uma instância RDS PostgreSQL

  1. Faça login na sua instância ECS ou máquina local e execute o seguinte comando:

    pg_basebackup -Ft -Pv -Xs -z -D <backupdir> -Z5 -h '<hostname>' -p <port> -U <username> -W

    A tabela a seguir descreve cada parâmetro e flag do comando. Para a referência completa de parâmetros, consulte pg_basebackup.

    Parâmetro ou flagDescrição
    -FtGera os arquivos de backup no formato tar.
    -PvExibe o progresso e a saída detalhada durante o backup (-P para progresso, -v para modo verboso).
    -XsTransmite arquivos WAL (Write-Ahead Logging) durante o backup pelo protocolo de replicação por streaming. Isso garante a consistência do backup e sua prontidão para PITR.
    -zComprime os arquivos de saída com gzip.
    -Z5Define o nível de compressão como 5 (intervalo: 1–9, onde 9 é a compressão máxima).
    -WSolicita uma senha.
    <backupdir>Diretório local onde os arquivos de backup são salvos. O pg_basebackup cria esse diretório automaticamente. Se o diretório já existir e não estiver vazio, o comando falhará com um erro.
    <hostname>Endpoint da sua instância RDS. Se suas instâncias ECS e RDS estiverem na mesma região, sob a mesma conta Alibaba Cloud e compartilharem o mesmo tipo de rede, use o endpoint interno. Caso ambas usem VPC (Virtual Private Cloud), elas devem estar na mesma VPC. Nos demais casos, use o endpoint público.
    Importante

    Para usar um endpoint público, solicite-o primeiro. Consulte Solicitar ou liberar um endpoint público.

    <port>Porta da sua instância RDS.
    <username>Nome de usuário da sua instância RDS.

    Exemplo:

    pg_basebackup -Ft -Pv -Xs -z -D /pg15/backup1/ -Z5 -h pgm-bp****.pg.rds.aliyuncs.com -p 5432 -U test1 -W
  2. Quando o prompt Password: aparecer, insira a senha do usuário e pressione Enter.

  3. O backup estará concluído quando a mensagem base backup completed for exibida.

Próximos passos

Para restaurar dados dos arquivos de backup, siga as etapas em Recuperação usando um backup de arquivamento contínuo.