描述

pg_rewind 是一個工具，用於在叢集的時間線分歧後，將 PostgreSQL 叢集與同一個叢集的另一個副本同步。一個典型的場景是在容錯移轉後將舊的主伺服器重新上線，作為追蹤新主伺服器的備用伺服器。

成功倒轉後，目標資料目錄的狀態類似於來源資料目錄的基礎備份。與建立新的基礎備份或使用像 rsync 這樣的工具不同，pg_rewind 不需要比較或複製叢集中未變更的關聯區塊。只複製現有關聯檔案中變更的區塊；所有其他檔案，包括新的關聯檔案、組態檔案和 WAL 段，都會完整複製。因此，當資料庫很大且叢集之間只有一小部分區塊不同時，倒轉操作明顯快於其他方法。

pg_rewind 檢查來源和目標叢集的時間線歷程，以判斷它們分歧的點，並預期在目標叢集的 pg_wal 目錄中找到 WAL，一直追溯到分歧點。可以在目標時間線、來源時間線或它們的共同祖先上找到分歧點。在典型的容錯移轉場景中，目標叢集在分歧後很快關閉，這不是問題，但如果目標叢集在分歧後運行了很長時間，其舊的 WAL 檔案可能不再存在。在這種情況下，您可以手動將它們從 WAL 封存複製到 pg_wal 目錄，或使用 -c 選項運行 pg_rewind 以自動從 WAL 封存檢索它們。pg_rewind 的使用不限於容錯移轉，例如，可以提升備用伺服器，運行一些寫入交易，然後倒轉以再次成為備用伺服器。

運行 pg_rewind 後，WAL 重播需要完成，資料目錄才能處於一致的狀態。當目標伺服器再次啟動時，它將進入封存恢復，並重播來源伺服器中從分歧點之前的最後一個檢查點開始的所有 WAL。如果在運行 pg_rewind 時，來源伺服器中的某些 WAL 不再可用，因此 pg_rewind 會話無法複製，則必須在啟動目標伺服器時使其可用。這可以透過在目標資料目錄中建立一個 recovery.signal 檔案，並在 postgresql.conf 中組態一個合適的 restore_command 來完成。

pg_rewind 要求目標伺服器在 postgresql.conf 中啟用 wal_log_hints 選項，或者在使用 initdb 初始化叢集時啟用資料校驗和。目前預設情況下這兩者都未啟用。full_page_writes 也必須設定為 on，但預設情況下已啟用。

選項

pg_rewind 接受下列命令列引數

環境

當使用 --source-server 選項時，pg_rewind 也會使用 libpq 支援的環境變數（請參閱 第 32.15 節）。

環境變數 PG_COLOR 指定是否在診斷訊息中使用顏色。可能的值為 always、auto 和 never。

注意事項

當使用線上叢集作為來源執行 pg_rewind 時，可以使用具有足夠權限的角色來執行 pg_rewind 在來源叢集上使用的函式，而不是超級使用者。以下是如何建立這樣一個角色，這裡命名為 rewind_user：

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;