PostgreSQL pg_rewind

簡介

pg_rewind是用于在集簇的時間線分叉以后，同步一個 PostgreSQL 集簇和同一集簇的另一份拷貝的工具。一種典型的場景是在失效后讓一個舊的主服務器重新上線，同時有一個后備機跟隨著新的主機。

成功回放后，目標數(shù)據(jù)目錄的狀態(tài)類似于源數(shù)據(jù)目錄的基本備份。與進行新的基本備份或使用rsync等工具不同，pg_rewind不需要比較或復制集群中未更改的關系塊。僅復制現(xiàn)有關系文件中更改的塊；所有其他文件（包括新的關系文件、配置文件和WAL段）都將被完整復制。因此，當數(shù)據(jù)庫很大并且集群之間只有一小部分塊不同時，倒帶操作比其他方法要快得多。

pg_rewind檢查源集簇和目標集簇的時間線歷史來判斷它們在哪一點分叉，并且期望在目標集簇的pg_wal目錄中找到 WAL 來返回到分叉點。分叉點可能會在目標時間線、源時間線或者它們的共同祖先上找到。在典型的失效場景中，目標集簇在分叉后很快就被關閉，這不是問題，但是如果目標集簇在分叉后已經(jīng)運行了很長時間，舊的 WAL 文件可能已經(jīng)不存在了。在這樣的情況下，您可以手動將它們從WAL存檔復制到 pg_wal目錄，或使用-c選項運行pg_rewind以自動從WAL存檔檢索它們。pg_rewind的使用并不限于失效的場景，例如一個后備服務器可能被提升、運行一些寫事務，然后被倒回再次成為一個后備。

在運行pg_rewind之后，需要完成WAL重放以使數(shù)據(jù)目錄處于一致狀態(tài)。當目標服務器再次啟動時，它將進入歸檔恢復，并從分歧點之前的最后一個檢查點重放源服務器中生成的所有 WAL。當pg_rewind被運行時有某些 WAL 在源服務器上不可用，并且因此無法被pg_rewind會話所復制，則在目標服務器被啟動時必須讓這些 WAL 可用。 這可以通過在目標數(shù)據(jù)目錄中創(chuàng)建一個recovery.signal文件并且在postgresql.conf中配置適合的restore_command來實現(xiàn)。

pg_rewind要求目標服務器在postgresql.conf中啟用了wal_log_hints選項，或者在用initdb初始化集簇時啟用了數(shù)據(jù)校驗。目前默認情況下這兩者都沒有被打開。 full_page_writes也必須被設置為on，這是默認的。

選項

pg_rewind接受下列命令行參數(shù)：

環(huán)境

在使用--source-server選項時，pg_rewind也使用libpq支持的環(huán)境變量（見第 33.14 節(jié)）。

環(huán)境變量PG_COLOR規(guī)定在診斷消息中是否使用顏色?？赡艿闹禐?code class="literal">always、auto、never。

注解

當使用在線群集作為源執(zhí)行pg_rewind時，具有充足權限來執(zhí)行pg_rewind在源群集上使用的函數(shù)的角色可以用來代替超級用戶。 這里介紹如何創(chuàng)建這樣的角色，在這里命名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;

當使用近期升級的在線群集作為源執(zhí)行pg_rewind時，必須在升級后執(zhí)行CHECKPOINT以便其控制文件反映最新的時間線信息， pg_rewind使用這些信息檢查目標群集是否可以使用指定的源群集倒回。