选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 当前版本 (18) / 17 / 17 / 16 / 16 / 15 / 15 / 14 / 14
测试与开发版本: 19 / 19 / devel / devel
不受支持的版本: 13 / 13 / 12 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3
历史版本PostgreSQL 9.5 已于 2021 年 2 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

pg_xlogdump

pg_xlogdump — 以人类可读的形式显示一个 PostgreSQL 数据库集簇的事务日志

大纲

pg_xlogdump [option...] [startseg [endseg] ]

描述

pg_xlogdump 显示事务日志(WAL),主要适用于调试或教学目的。

这个工具只能由安装服务器的用户运行,因为它需要对数据目录的只读访问权限。

选项

下列命令行选项控制输出的位置和格式:

startseg

从指定的日志段文件开始读取。这隐式地决定了搜索文件的路径以及要使用的时间线。

endseg

读完指定的日志段文件后停止。

-b
--bkp-details

输出有关备份块的详细信息。

-e end
--end=end

在指定的日志位置停止读取,而不是读到日志流的末尾。

-f
--follow

到达有效 WAL 的末尾后,继续每秒轮询一次,等待新的 WAL 出现。

-n limit
--limit=limit

显示指定数量的记录,然后停止。

-p path
--path=path

查找日志段文件的目录。默认在当前目录的 pg_xlog 子目录中搜索。

-r rmgr
--rmgr=rmgr

只显示由指定资源管理器生成的记录。如果名称传入 list,则打印有效资源管理器名称的列表并退出。

-s start
--start=start

开始读取的日志位置。默认从找到的最早文件中的第一个有效日志记录开始读取。

-t timeline
--timeline=timeline

读取日志记录所用的时间线。如果指定了 startseg,默认使用其中的值;否则默认为 1。

-V
--version

打印 pg_xlogdump 的版本并退出。

-x xid
--xid=xid

只显示标有给定事务 ID 的记录。

-z
--stats[=record]

显示汇总统计信息(记录数和大小以及整页镜像数),而不是每条记录。可以选择按记录而不是按资源管理器生成统计信息。

-?
--help

显示有关 pg_xlogdump 命令行参数的帮助并退出。

注解

服务器运行时可能给出错误的结果。

只显示指定的时间线(若未指定则为默认时间线)。其他时间线中的记录会被忽略。

pg_xlogdump 无法读取带 .partial 后缀的 WAL 文件。如果需要读取这些文件,必须从文件名中去掉 .partial 后缀。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。