Descrição

O utilitário pg_rewind é uma ferramenta que permite sincronizar uma instância do PostgreSQL com uma cópia dessa mesma instância, após as linhas do tempo dessas instâncias divergirem. O contexto típico é a reativação do servidor primário antigo após a comutação (failover), colocando-o como um servidor em-espera replicando o novo servidor primário.

Após a sincronização bem-sucedida, o estado do armazenamento de dados do destino é análogo a uma cópia de segurança base do armazenamento de dados da origem. Diferentemente de fazer uma nova cópia de segurança base, ou usar uma ferramenta como rsync, o utilitário pg_rewind não requer comparação ou cópia de blocos de relação não alterados na instância. Somente blocos alterados dos arquivos de relação existentes são copiados; todos os outros arquivos, incluindo os novos arquivos de relação, arquivos de configuração, e segmentos de WAL, são copiados por inteiro. Como tal, a operação de sincronização é muito mais rápida do que outras abordagens quando o banco de dados é grande, e apenas uma pequena fração dos blocos difere entre as instâncias.

O utilitário pg_rewind examina os históricos de linha do tempo das instâncias de origem e de destino para determinar o ponto em que divergiram, e espera encontrar o WAL no diretório pg_wal da instância de destino, para refazer todo o caminho de volta ao ponto de divergência. O ponto de divergência pode ser encontrado na linha do tempo do destino, na linha do tempo da origem, ou no ancestral comum. No contexto de comutação típico, em que a instância de destino foi parada logo após a divergência, isto não é um problema, mas se a instância de destino foi executada por um longo período após a divergência, seus arquivos de WAL antigos poderão não estar mais presentes. Neste caso, pode-se copiá-los manualmente do arquivamento de WAL para o diretório pg_wal, ou executar o utilitário pg_rewind com a opção -c para recuperar automaticamente do arquivamento de WAL. O uso do utilitário pg_rewind não está limitado à comutação, por exemplo, um servidor em-espera pode ser promovido, executar algumas transações de escrita e, em seguida, retroceder para se tornar um servidor em-espera novamente.

Após executar o utilitário pg_rewind, a reprodução do WAL precisa ser concluída para que o diretório de dados fique em um estado consistente. Quando o servidor de destino for ativado novamente, ele entrará em recuperação do arquivamento, e reproduzirá todo o WAL gerado no servidor de origem desde o último ponto de verificação antes do ponto de divergência. Se algum arquivo de WAL não estava mais disponível no servidor de origem quando pg_rewind foi executado, e, portanto, não pôde ser copiado pela sessão do pg_rewind, ele deverá ser disponibilizado quando o servidor de destino for ativado. Isto pode ser feito criando o arquivo recovery.signal no diretório de dados de destino, e configurando o restore_command adequado no arquivo postgresql.conf.

O utilitário pg_rewind requer que o servidor de destino tenha a opção wal_log_hints ativa no arquivo postgresql.conf, ou somas de verificação de dados ativas quando a instância foi inicializada com o initdb (o padrão). A definição de full_page_writes também deve estar definida como on, mas está ativa por padrão.

Opções

O utilitário pg_rewind aceita os seguintes argumentos de linha de comando:

Variáveis de ambiente

Quando é usada a opção --source-server, o utilitário pg_rewind também usa as variáveis de ambiente com suporte pela libpq (veja Variáveis ​​de ambiente).

A variável de ambiente PG_COLOR especifica se devem ser usadas cores nas mensagens de diagnóstico. Os valores possíveis são always, auto e never.

Notas

Ao executar o utilitário pg_rewind usando uma instância ativa como origem, pode ser usada uma função de banco de dados (role) com permissões suficientes para executar as funções usadas por pg_rewind na instância de origem, em vez de um superusuário. A seguir está mostrado como criar esta função de banco de dados, chamada rewind_user aqui:

CREATE USER rewind_user LOGIN;
GRANT EXECUTE ON function pg_catalog.pg_ls_dir(text, boolean, boolean) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_stat_file(text, boolean) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_read_binary_file(text) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_read_binary_file(text, bigint, bigint, boolean) TO rewind_user;