金仓数据库KingbaseES服务器应用参考手册--12. sys_waldump

12.1. 简介：

sys_waldump— 以可读的形式显示一个KingbaseES数据库集簇的预写式日志

sys_waldump显示预写式日志（WAL），它主要用于调试目的。这个工具只能由安装该服务器的用户运行，因为它要求对数据目录的只读访问。

12.2. 命令行参数：

sys_waldump [option...] [startseg [endseg]]

12.3. 参数说明：

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

startseg

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

endseg

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

-b

--bkp-details

输出有关备份块的细节。

--block-size=size

设置表块大小，以千字节为单位。默认的尺寸为8千字节。该值必须是2的整数次幂，并且在1到32之间。这个选项需要与 initdb 设置的--block-size大小保持一致，否则会影响相关的计算结果。

-e end

--end=end

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

-f

--follow

在到达可用 WAL 的末尾之后，保持每秒轮询一次是否有新的 WAL 出现。

-n limit

--limit=limit

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

-p path

--path=path

指定搜索日志段文件的目录或包含这些文件的包含sys_wal子目录的目录。 缺省值是在当前目录中搜索，当前目录的sys_wal子目录和 KINGBASE_DATA的sys_wal子目录。

-r rmgr

--rmgr=rmgr

只显示由指定资源管理器生成的记录。如果把list作为资源管理器名称传递给这个选项，则打印出可用资源管理器名称的列表然后退出。

-s start

--start=start

要从哪个WAL位置开始读取。默认是从找到的最早的文件的第一个可用日志记录开始。

-t timeline

--timeline=timeline

要从哪个时间线读取日志记录。默认是使用startseg（如果指定）中的值，否则默认为 1。

-V

--version

打印 sys_waldump版本并且退出。

-x xid

--xid=xid

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

-z

--stats[=record]

显示概括统计信息（记录的数量和尺寸以及全页镜像）而不是显示每个记录。可以选择针对每个记录生成统计信息，而不是针对每个资源管理器生成。

-?

--help

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

12.4. 环境变量：

KINGBASE_DATA

数据目录，参考-p选项.

SYS_COLOR

指定是否在诊断消息中使用颜色。可能的值是always, auto, never.

12.5. 错误信息诊断：

无

12.6. 备注：

当服务器正在运行时可能会给出错误的结果。只有指定的时间线 会被显示（如果没有指定，则显示默认时间线）。其他时间线上的记录会被忽略。

sys_waldump不能读取具有后缀.partial 的 WAL 文件。如果需要读取那些文件，需要从文件名中移除 .partial后缀。

12.7. 参考：

无