# pg_resetxlog ## Name pg_resetxlog?--?重置一個數據庫集群的預寫日志以及其它控制內容 ## Synopsis `pg_resetxlog` [`-f`] [`-n`] [`-o` `_oid_`] [`-x` `_xid_`] [`-e` `_xid_epoch_`] [`-m` `_mxid_`,`_mxid_`] [`-O` `_mxoff_`] [`-l` `_xlogfile_`] `_datadir_` ## 描述 `pg_resetxlog`清理預寫日志(WAL)并且可以有選擇地重置其它一些存儲在 `pg_control`文件中的控制信息。有時候，如果這些文件崩潰了，就需要這個功能。 一定只把它用作最后的方法，就是說只有因為這樣的崩潰導致服務器無法啟動的時候才使用。 運行這個命令之后，可能就可以啟動服務器了，但是， 一定要記住數據庫可能因為部分提交的事務而含有不完整的數據。你應該馬上轉儲數據， 運行`initdb`，然后重新加載。在重新加載之后， 檢查不完整的部分然后根據需要進行修復。 這個命令只能由安裝服務器的用戶運行，因為它需要對數據目錄的讀寫權限。 出于安全考慮，`pg_resetxlog`不使用環境變量`PGDATA`， 你必須在命令行上聲明數據目錄。 如果`pg_resetxlog`抱怨說它無法判斷用于`pg_control` 的有效數據，那么你可以強制它繼續處理，方法是聲明`-f`(強制)開關。 在這種情況下，那些丟失了的數據將用模糊的近似數值代替。大多數字段都可以匹配上， 但是下一個 OID 、下一個事務 ID 、下一個事務 ID 的 epoch(時間點)、 下一個多事務 ID(兩階段提交的東西)、下一個多事務偏移量、WAL 開始地址可能需要手工幫助， 這些字段可以使用下面討論的選項設置。如果你不能判斷所有這些字段的正確數值， 那么`-f`仍然可以使用，但是這樣恢復過來的數據庫正確性更值得懷疑： 立即轉儲和重新加載是必須的。在轉儲之前_不要_執行任何修改數據的操作， 因為任何這樣的動作都可能把事情搞得更糟糕。 `-o`, `-x`, `-e`, `-m`, `-O`, `-l` 開關允許手工設置下一個 OID 、下一個事務 ID 、下一個事務 ID epoch 、 下一個和最舊的多事務 ID 、下一個多事務偏移量、WAL 起始位置的數值。 只有在`pg_resetxlog`無法通過讀取`pg_control` 判斷合適的數值的時候才需要它。安全的數值可以用下面的方法判斷： * 對于下一個事務 ID(`-x`)而言，一個安全的數值是看看數據目錄里的 `pg_clog`里數值最大的文件名，然后加一，然后再乘上 1048576 。 請注意那些文件名是十六進制的。通常也以十六進制的形式聲明選項值是最簡單的。 比如，如果`0011`是`pg_clog`里最大的記錄， `-x 0x1200000`就可以了(后面的五個零提供了合適的乘積)。 * 下一個多事務 ID(`-m`的第一部分)的安全值可以通過查看數據目錄里 `pg_multixact/offsets`子目錄里面的數字最大的文件名，加一， 然后乘以 65536 得到。相反的，最老多事務ID（`-m`的第二部分） 的安全值可以通過查看相同目錄里的數字最小的文件名，然后乘以65536得到。 和上面一樣，文件名是十六進制的，因此最簡單的方法是給選項聲明一個十六進制的開關值， 然后在結尾加四個零。 * 下一個多事務偏移量(`-O`)的安全值可以通過檢查數據目錄里 `pg_multixact/members`子目錄下的數字最大的文件名，加一， 然后乘以 65536 得到。和上面一樣，文件名是十六進制的。 這里沒有像上面一樣添加零的簡單方法。 * WAL 的起始位置(`-l`)應該比目前存在于數據目錄`pg_xlog` 里面的任何WAL段文件號都大。它的文件名也是十六進制的，并且有三部分。 第一部分是"時間線 ID"，通常應該保持相同。比如， 如果`00000001000000320000004A`是`pg_xlog`里最大的條目， 那么選擇`-l 00000001000000320000004B`或更多。 > **Note:** `pg_resetxlog`本身查看`pg_xlog`里面的文件， 并選擇一個缺省的超過最后一個現存文件號的`-l`設置。因此， 只有知道WAL段文件當前不在`pg_xlog`中時，才需要手動調整`-l`， 例如離線歸檔中的條目；或如果`pg_xlog`的內容完全丟失。 * 沒有很容易的辦法來判斷比數據庫中最大的 OID 大一號的下一個 OID ， 不過很走運的是獲取正確的下一個 OID 并非非常關鍵的事情。 * 除了由`pg_resetxlog`設定的字段外， 事務 ID epoch 實際上并未存儲在數據庫里的任何地方。 所以只要是涉及到數據庫自身的任何數值都有效。你可能需要調整這個值以確保諸如 Slony-I之類的備份系統能夠正常工作。如果是這樣的話， 應當從下游已復制的數據庫中獲取恰當的值。 `-n`(無操作)選項指示`pg_resetxlog`打印從 `pg_control`重新構造的數值然后不修改任何值就退出。這主要是一個調試工具， 但是在`pg_resetxlog`真正處理前進行的合理性檢查的時候可能會有用。 `-V` 和 `--version`選項打印pg_resetxlog 的版本然后退出。選項`-?` 和 `--help`顯示參數的支持信息然后退出。 ## 注意 在服務器運行的時候一定不要運行這個命令。如果發現在數據文件目錄里有鎖文件， 那么`pg_resetxlog`將拒絕啟動。如果服務器崩潰， 那么可能會剩下一個鎖文件；如果這樣，你可以刪除該鎖文件以便允許 `pg_resetxlog`運行。但是在你這么做之前， 一定要確保沒有任何后端服務器進程仍在運行。