pg_waldump — 顯示 PostgreSQL 資料庫叢集的預寫式日誌的人工可讀呈現方式
pg_waldump
[選項
...] [startseg
[endseg
]]
pg_waldump
顯示預寫式日誌 (WAL),主要用於除錯或教育目的。
這個工具只能由安裝伺服器的使用者執行,因為它需要對資料目錄的唯讀存取權。
以下命令列選項控制輸出的位置和格式
startseg
從指定的 WAL 段檔案開始讀取。 這隱含地決定了將搜尋檔案的路徑,以及要使用的時間線。
endseg
在讀取指定的 WAL 段檔案後停止。
-b
--bkp-details
輸出關於備份區塊的詳細資訊。
-B 區塊
--block=區塊
僅顯示修改給定區塊的記錄。 關聯也必須透過 --relation
或 -R
提供。
-e 結束
--end=結束
在指定的 WAL 位置停止讀取,而不是讀取到日誌串流的結尾。
-f
--follow
在到達有效的 WAL 結尾後,每秒輪詢一次以查看是否有新的 WAL 出現。
-F fork
--fork=fork
僅顯示修改給定 fork 中區塊的記錄。有效值為 main
用於主 fork,fsm
用於可用空間映射,vm
用於可見性映射,以及 init
用於初始化 fork。
-n 限制
--limit=限制
顯示指定數量的記錄,然後停止。
-p 路徑
--path=路徑
指定一個目錄以搜尋 WAL 段檔案,或包含具有此類檔案的 pg_wal
子目錄的目錄。 預設是在目前目錄、目前目錄的 pg_wal
子目錄和 PGDATA
的 pg_wal
子目錄中搜尋。
-q
--quiet
除了錯誤之外,不印出任何輸出。 當您想知道是否可以成功解析一系列 WAL 記錄,但不關心記錄內容時,此選項很有用。
-r rmgr
--rmgr=rmgr
僅顯示由指定資源管理器產生的記錄。 您可以多次指定此選項以選擇多個資源管理器。 如果將 list
作為名稱傳遞,則印出有效資源管理器名稱的列表,然後結束。
擴充功能可能會定義自訂資源管理器,但是 pg_waldump 不會載入擴充功能模組,因此無法按名稱識別自訂資源管理器。 相反,您可以將自訂資源管理器指定為 custom###
,其中 ###
是三位數的資源管理器 ID。 這種形式的名稱將始終被視為有效。
-R tblspc
/db
/rel
--relation=tblspc
/db
/rel
僅顯示修改給定關聯中區塊的記錄。 該關聯使用表空間 OID、資料庫 OID 和 relfilenode(以斜線分隔)指定,例如 1234/12345/12345
。 這與程式輸出中用於關聯的格式相同。
-s 開始
--start=開始
從哪個 WAL 位置開始讀取。 預設是從最早找到的檔案中找到的第一個有效 WAL 記錄開始讀取。
-t 時間線
--timeline=時間線
從哪個時間線讀取 WAL 記錄。 預設是使用 startseg
中的值(如果已指定);否則,預設值為 1。 該值可以用十進制或十六進制指定,例如 17
或 0x11
。
-V
--version
印出 pg_waldump 版本並結束。
-w
--fullpage
僅顯示包含完整頁面映像的記錄。
-x xid
--xid=xid
僅顯示標記有給定事務 ID 的記錄。
-z
--stats[=record]
顯示摘要統計資訊(記錄和完整頁面映像的數量和大小),而不是單個記錄。 或者,產生每個記錄(而不是每個 rmgr)的統計資訊。
如果 pg_waldump 因訊號 SIGINT (Control+C) 終止,則會顯示計算出的統計摘要到終止點。 Windows 不支援此操作。
--save-fullpage=save_path
將 WAL 記錄中找到的完整頁面映像儲存到 save_path
目錄。 儲存的映像受到與顯示的記錄相同的篩選和限制條件的約束。
完整頁面映像以以下檔案名稱格式儲存:
檔案名稱由以下部分組成TIMELINE
-LSN
.RELTABLESPACE
.DATOID
.RELNODE
.BLKNO
_FORK
元件 | 說明 |
---|---|
TIMELINE | 記錄所在 WAL 段檔案的時間線,格式為一個 8 個字元的十六進制數字 %08X |
LSN | 此紀錄的LSN格式為兩個8字元的十六進制數字 %08X-%08X |
RELTABLESPACE | 區塊的資料表空間 OID |
DATOID | 區塊的資料庫 OID |
RELNODE | 區塊的 filenode |
BLKNO | 區塊的區塊編號 |
FORK | 完整頁面映像檔來自的分支名稱,例如 main 、fsm 、vm 或 init 。 |
-?
--help
顯示關於 pg_waldump 命令列引數的說明,然後結束。
PGDATA
資料目錄;另請參閱 -p
選項。
PG_COLOR
指定是否在診斷訊息中使用顏色。可能的值為 always
、auto
和 never
。
當伺服器正在執行時,可能會產生錯誤的結果。
僅顯示指定的時間線(如果未指定,則為預設時間線)。其他時間線中的紀錄將被忽略。
pg_waldump 無法讀取帶有後綴 .partial
的 WAL 檔案。 如果需要讀取這些檔案,則需要從檔案名稱中刪除 .partial
後綴。
如果您在文件中發現任何不正確、與您使用特定功能的經驗不符或需要進一步澄清的內容,請使用此表格來報告文件問題。