說明

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;