达梦数据库dmlcvt日志工具应用

这节通过具体的示例来谈谈dmlcvt日志工具的用法，选择不同的参数设置实现不同的分析需求。
dmlcvt日志工具应用

参数F_TYPE取值不同，解析的对象也不同。当F_TYPE=1时，指定归档目录，程序会解析目录下所有归档日志文件；当F_TYPE=2时，指定单个归档日志文件，程序只解析指定的归档日志文件；当F_TYPE=3时，指定单个联机日志文件，程序只解析指定的联机日志文件；当F_TYPE=4时，指定 dm.ini 文件，程序会解析 dm.ini 中指定的控制文件找出所有联机日志文件。
1.归档目录操作
F_TYPE=1 对应归档目录操作，此时要求 F_PATH 必须指向有效的归档目录路径，OP_TYPE 可以指定，但是只能为1，即仅支持默认的日志内容打印操作。打印内容生成到相应的报告中，详见 6 报告解读 。
每次仅能执行一个库中一个节点的归档日志。若指定归档目录中存在多个库的归档日志（即存在 DB_MAGIC 不同的归档日志），则给出 DB_MAGIC 的选择；若存在同个库的多个节点号的日志（如，RAC 环境中不同节点的归档日志放到一个目录中），则给出节点号选择提示。
若归档日志为加密库的日志，则需指定 DM_INI，且 DM_INI 对应目标库必须可以正常访问。
若归档目录存在于 ASM 上，或者指定 DM_INI 情况下，DM_INI 中控制文件 dm.ctl 或者系统文件存在于 ASM 上，则需要指定 DCR_INI。
查看数据库已经产生的归档日志文件。

由于归档日志中存在多个DB_MAGIC 值，需要用户确定合适的DB_MAGIC值。

输入合适的DB_MAGIC值，重新对归档日志进行解析。

2．归档日志文件操作

F_TYPE=2时对应归档文件操作，此时F_PATH必须指向有效的归档日志文件。OP_TYPE可选值为 1、2、3、4，若未指定，则默认为 1。
指定归档日志操作，会先将归档日志的简要信息进行打印。详见报告解读中file_infoxxx.txt 说明。
若归档日志为日志加密库产生的归档日志，其他 OP_TYPE=1 或者未指定，则需要指定DM_INI 且 DM_INI 对应库必须可以正常访问。OP_TYPE=2、3、4 均不涉及日志内容，无效处理加密情况。
若指定归档文件存在于 ASM 上，或者指定 DM_INI 情况下，DM_INI 中 dm.ctl 或者系统文件存在于 ASM 上，则需要指定DCR_INI。
指定 op_type=1 或者不指定 op_type，对应日志内容打印操作。指定普通库中归档文件日志操作，并将结果输出到 OUT_PATH 指定目录中。如下图所示：

3. 联机日志文件操作

F_TYPE=3时，对应指定联机日志文件操作，此时F_PATH必须指向单个联机日志文件。因要确认联机日志文件所属库是否处于运行状态，所以 DM_INI 建议指定，若未指定，则给出选择是否继续，所属库是否运行由用户自行确定。
单个联机日志文件操作仅指定默认的日志内容打印操作。允许通过指定 F_OFFSET 和CALC_OFF，来指定从指定偏移打印，以及是否需要计算第一个有效 PTX 的起始位置。CALC_OFF 在指定 F_OFFSET 情况下生效，默认 CALC_OFF 为 0，不执行第一个有效 PTX的计算。若指定 CALC_OFF 为 1，则 F_OFFSET 必须以 512 对齐；否则，若 F_OFFSET 不以 512 对齐，则余数作为第一个访问日志页的页内偏移使用。
默认不指定 F_OFFSET 和 CALC_OFF，若执行失败或者异常，可通过调整 F_OFFSET和指定 CALC_OFF 重新执行。
不指定 F_OFFSET/CALC_OFF，执行单个日志文件内容打印操作（日志文件未循环覆盖，指定联机日志文件中第一页即为有效日志页情况）。如下图所示：

4.dm.ini 文件 操作
F_TYPE=4 对应指定某个库的 dm.ini 操作，此时 F_PATH 必须指定有效的 dm.ini 文件。Op_type 可选择 1、2、3、4、5，默认 1。
若指定dm.ini的库中联机日志或者控制文件dm.ctl或者系统文件（如system.dbf）存在在与 ASM 上，则需指定 DCR_INI。
指定 dm.ini 执行联机日志内容打印时，会先将当前联机日志情况进行简要打印。
指定 op_type=1 或者不指定 op_type 对应日志内容打印操作。打印过程为从 CKPT位置开始向后打印。由于联机日志文件会以日志环的形式循环利用，所以，日志文件中 LSN值等可能会出现回滚的现象，会在回滚处执行截断打印，回滚的日志内容会生成到新的报告文件（rec_infoxxx.txt、page_infoxxx.txt）中，并在 file_infoxxx.txt 中给出说明。如下图所示：

5.报告解读
dmlcvt工具各种操作过程中，可能生成的报告有 5个,分别为：
file_infoxxx.txt 打印执行过程中的操作信息、文件信息等。warn_infoxxx.txt 打印执行过程中的警告信息和错误信息。rec_infoxxx.txt  打印 RREC 记录信息。
page_infoxxx.txt 打印日志页信息。
ref_pagesxxx.txt 打印收集到的数据页记录。
1)file_infoxxx.txt文件信息报告，包括当前操作的文件信息，以及操作过程中提示性信息等。内容与dmlcvt 工具执行过程中控制台打印基本一致。如下图所示：

归档日志文件信息报告各字段说明如下：
File_name：归档文件路径。
Version：归档文件日志版本号。
Arch_lsn：归档文件起始 LSN。
Clsn：归档文件结束 LSN。
Arch_seq：归档文件中起始日志页 SEQ。
Next_seq：归档文件中结束日志页 SEQ。
Db_magic: 归档文件所属库的 DB_MAGIC 值。
Pemnt_magic：归档文件所属库的 PEMNENT_MAGIC 值。
Rac_seqno：归档文件所属库中生成日志的节点号。
Rac_node：归档文件所属库的节点数。
2)warn_infoxxx.txt记录操作过程中出现的警告和错误信息。如果操作过程中一直没有出现错误，那么这个报告一直是空的。如下图所示

3)page_infoxxx.txt，当且仅当 OP_TYPE=1、PAGE_INFO=1 时，生成的访问到的各日志页的信息的报告。如下图所示：

各字段含义：
Node：联机日志文件或者归档日志文件所属库对应的节点号，单机环境始终为 0。
Rpag_seq：日志页序号，同一个库中同一路归档日志中日志页序号是连续的；联机日志页中日志页序号可能会回卷，但会生成到不同的报告文件中。
Rpag_magic：日志页上魔数。
Rpag_len：日志页使用长度。
Ptx_lsn：日志页上第一个 PTX 的 LSN 值。
Ptx_count in page：日志页中存放 PTX 的个数。
4)rec_infoxxx.txt,当且仅当 OP_TYPE=1 时，生成记录物理事务信息和事务对应的记录信息报告。用户可以通过参数 REC_LEVEL 来设置，是打印物理事务信息（ptx)，还是事务对应的记录信息。默认是两者都打印。
如下图所示：

4)ref_pagesxxx.txt，当且仅当 F_TYPE=4、op_type=4 时，生成从联机日志文件中指定 LSN 开始收集到的使用数据页信息报告。如下图所示：

报告中记录的数据页信息包括 3 个字段，按顺序分别为：所在表空间 ID、所在数据文件 ID、数据页本身编号。

本节对dmlcvt工具的进行实际使用，它确实方便了数据库管理人员对日志进行解析，通过正确使用该工具，为我们判断故障，提高性能提供了很好的途径。