描述

pg_rewind 是一個用於在 PostgreSQL 叢集的邏輯時間線（timeline）發生分叉後，將一個 PostgreSQL 叢集與同一個叢集的另一個副本進行同步的工具。一個典型的場景是在主備切換後，將舊的主伺服器重新上線，使其成為跟隨新主伺服器的備伺服器。

成功執行 rewind 操作後，目標資料目錄的狀態類似於源資料目錄的基礎備份。與執行新的基礎備份或使用 rsync 等工具不同，pg_rewind 不需要比較或複製叢集中未更改的關聯塊。它只複製現有關聯檔案中已更改的塊；所有其他檔案，包括新的關聯檔案、配置檔案和 WAL 段，都會被完整複製。因此，當資料庫很大而叢集之間只有一小部分塊不同時，rewind 操作會比其他方法快得多。

pg_rewind 會檢查源叢集和目標叢集的時間線歷史，以確定它們分叉的點，並期望在目標叢集的 pg_wal 目錄中找到一直追溯到分叉點的 WAL。分叉點可能位於目標時間線、源時間線或它們的共同祖先上。在典型的切換場景中，目標叢集在分叉後很快關閉，這不是問題。但如果目標叢集在分叉後運行了很長時間，其舊的 WAL 檔案可能已不再存在。在這種情況下，您可以手動將它們從 WAL 歸檔複製到 pg_wal 目錄，或者執行帶有 -c 選項的 pg_rewind 來自動從 WAL 歸檔檢索它們。pg_rewind 的使用不限於切換場景，例如，可以將備伺服器提升為主伺服器，執行一些寫事務，然後再進行 rewind 操作使其重新成為備伺服器。

執行 pg_rewind 後，需要完成 WAL 重放（replay），資料目錄才能處於一致狀態。當目標伺服器再次啟動時，它將進入歸檔恢復（archive recovery）模式，並重放從分叉點之前最後一個檢查點開始由源伺服器生成的全部 WAL。如果在執行 pg_rewind 時源伺服器上的一些 WAL 已不再可用，因此無法被 pg_rewind 會話複製，那麼在目標伺服器啟動時必須提供這些 WAL。這可以透過在目標資料目錄中建立 recovery.signal 檔案，並在 postgresql.conf 中配置合適的 restore_command 來實現。

pg_rewind 要求目標伺服器的 postgresql.conf 中啟用 wal_log_hints 選項，或者在初始化叢集時啟用了資料校驗和（data checksums）。這兩個選專案前預設都未開啟。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;