支援的版本:目前 (17) / 16 / 15 / 14 / 13
開發版本:devel
不支援的版本:12 / 11 / 10

pg_waldump

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 子目錄和 PGDATApg_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。 該值可以用十進制或十六進制指定,例如 170x11

-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 完整頁面映像檔來自的分支名稱,例如 mainfsmvminit
-?
--help

顯示關於 pg_waldump 命令列引數的說明,然後結束。

環境變數

PGDATA

資料目錄;另請參閱 -p 選項。

PG_COLOR

指定是否在診斷訊息中使用顏色。可能的值為 alwaysautonever

注意

當伺服器正在執行時,可能會產生錯誤的結果。

僅顯示指定的時間線(如果未指定,則為預設時間線)。其他時間線中的紀錄將被忽略。

pg_waldump 無法讀取帶有後綴 .partial 的 WAL 檔案。 如果需要讀取這些檔案,則需要從檔案名稱中刪除 .partial 後綴。

另請參閱

第 28.6 節

提交更正

如果您在文件中發現任何不正確、與您使用特定功能的經驗不符或需要進一步澄清的內容,請使用此表格來報告文件問題。