达梦数据复制软件DMDRS控制台命令-DMDRS跟踪命令

8 跟踪命令

介绍DMDRS跟踪功能的相关命令。

8.1 添加源DMDRS跟踪

命令功能

对源DMDRS添加或删除跟踪，跟踪源DMDRS表同步信息，并将跟踪日志信息记录在当前log目录下的跟踪日志文件中。方便监控表的操作信息，如遇问题也可方便快速定位。

当添加跟踪后，跟踪表信息会记录在当前模块名目录下的trace.ini文件中，DMDRS重启后会自动加载已有表的跟踪信息，跟踪大对象信息、事务信息重启后不会自动加载。同时可使用show trace命令查看已添加的跟踪表信息。

说明

不支持通过表ID对MySQL/MariaDB数据库的同步表添加和删除跟踪。

该命令不适用于SQL Server数据库。

命令格式

TRACE <CPT_NAME> [ID|"[<DBNAME>.] <SCHNAME>.<TABNAME>"] [<trace_mask>] ADD|DELETE|CLEAR

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。
ID\|"[<DBNAME>.] <SCHNAME>.<TABNAME>"	通过表ID或者表名对同步表添加和删除跟踪。 ID：跟踪表ID。 [<DBNAME>.] <SCHNAME>.<TABNAME>：数据库名.模式名.表名。
trace_mask	跟踪掩码。 DICT：跟踪同步表对象的字典流程。 PARSE：跟踪同步表对象的捕获解析流程。 COL_INFO：跟踪同步表对象的列信息，包括列类型、列值等。 OP_MSG：跟踪同步表内部消息封装等流程。 SEND：跟踪发送消息的OP和LSN信息（仅适用于Oracle、MySQL/MariaDB数据库）。 DDL：跟踪同步表对象的DDL操作流程。 LOB：跟踪同步大对象信息，不区分同步表。 TRX：跟踪同步事务信息，不区分同步表（仅适用于Oracle、DM8数据库）。不指定跟踪掩码时，默认掩码组合为：DICT\|PARSE\|COL_INFO\|OP_MSG
ADD\|DELETE\|CLEAR	ADD：添加跟踪。 DELETE：删除跟踪。 CLEAR：清空跟踪信息。清空跟踪信息时，不能配置表ID和表名。

命令示例

跟踪源DMDRS的模式名为“DMDRS”、表名为“TEST_TRACE”的表的操作信息，跟踪掩码设置为DICT|PARSE。

CSL> trace cpt_ora "DMDRS.TEST_TRACE" DICT|PARSE add
MGR[INFO]:  检测到表字典，添加表对象跟踪 table: .DMDRS.TEST_TRACE [id:139705] mask:|DICT|PARSE

跟踪结果为：

删除源DMDRS的模式名为“DMDRS”、表名为“TEST_TRACE”的表的部分跟踪掩码，如删除DICT掩码。

CSL>trace cpt_ora "DMDRS.TEST_TRACE" DICT delete
MGR[INFO]:  跟踪对象掩码已删除更新 table: .DMDRS.TEST_TRACE mask:|PARSE

删除源DMDRS的模式名为“DMDRS”、表名为“TEST_TRACE”的表跟踪。

当需要删除跟踪表时，指定当前表已有的全部跟踪掩码或者不指定任何掩码，如果只需要删除部分跟踪掩码，则指定删除的跟踪掩码。

如当表仅含有PARSE掩码，再进行删除时，则删除该表跟踪。
```
CSL>trace cpt_ora "DMDRS.TEST_TRACE" PARSE delete
MGR[INFO]:  跟踪对象已删除 table: .DMDRS.TEST_TRACE mask:|PARSE
```
设置LOB跟踪。

跟踪全部大对象同步的数据流程，包括大对象分片创建、分片发送等。
```
CSL>trace cpt_ora lob add
MGR[INFO]:  大字段跟踪已设置
```

删除LOB跟踪。

删除对大对象同步流程的跟踪。

CSL>trace cpt_ora lob delete
MGR[INFO]:  大对象跟踪已取消

设置TRX跟踪。

跟踪全部事务同步的流程，包括事务创建、事务提交和事务回滚等。
```
CSL>trace cpt_ora trx add
MGR[INFO]:  事务跟踪已设置
```

取消TRX跟踪。

取消全部事务的跟踪流程。

CLS>trace cpt_ora trx delete
MGR[INFO]:  事务跟踪已取消

设置SEND跟踪。

跟踪发送线程发送消息的OP和LSN等。
```
CSL>trace cpt_ora send add
MGR[INFO]:  发送跟踪已设置
```

清空跟踪信息。

CLS>trace cpt_ora clear
MGR[INFO]:  跟踪信息已清空

8.2 添加目标DMDRS跟踪

命令功能

对目标DMDRS添加或删除跟踪，跟踪目标DMDRS表同步信息，并将跟踪日志信息记录在相应站点的日志文件中。方便监控表的操作信息，如遇问题也可方便快速定位。

当添加跟踪后，跟踪表信息会记录在当前模块名目录下的trace.ini文件中，DMDRS重启后会自动加载已有表的跟踪信息。

说明

不支持通过表ID对MySQL/MariaDB数据库的同步表添加和删除跟踪。

不支持通过表ID对分区表、Oracle索引组织表（IOT）添加和删除跟踪。

命令格式

TRACE <EXEC_NAME> [ID|"[<DBNAME>.] <SCHNAME>.<TABNAME>"] ADD|DELETE|CLEAR

参数说明

参数	说明
EXEC_NAME	EXEC模块的名称，对应配置文件中EXEC模块的“name”参数。
ID\|"[<DBNAME>.] <SCHNAME>.<TABNAME>"	通过表ID或者表名对同步表添加和删除跟踪。 ID：跟踪表ID。 [<DBNAME>.] <SCHNAME>.<TABNAME>：数据库名.模式名.表名。
ADD\|DELETE\|CLEAR	ADD：添加跟踪。 DELETE：删除跟踪。 CLEAR：清空跟踪信息。清空跟踪信息时，不能配置表ID和表名。

命令示例

跟踪目标DMDRS的模式名为“DMDRS”、表名为“TEST_TRACE”的表的操作信息。

CSL> trace exec_dm8 "DMDRS.TEST_TRACE" add
CSL[INFO]:  [INPUT CMD: trace exec_dm8 "DMDRS.TEST_TRACE" add]
MGR[INFO]:  表对象已设置跟踪 obj:DMDRS.TEST_TRACE

截取跟踪结果为：

删除目标DMDRS的模式名为“DMDRS”、表名为“TEST_TRACE”的表的跟踪。

CSL>trace exec_dm8 "DMDRS.TEST_TRACE" delete
CSL[INFO]:  [INPUT CMD: trace exec_dm8 "DMDRS.TEST_TRACE" delete]
MGR[INFO]:  跟踪对象已删除 obj:DMDRS.TEST_TRACE

清空跟踪信息。

CLS>trace exec_dm8 clear
MGR[INFO]:  跟踪信息已清空

8.3 查看DMDRS跟踪

命令功能

查看指定CPT模块或者EXEC模块的跟踪表信息。

命令格式

SHOW [<CPT_NAME>|<EXEC_NAME>] TRACE [[<DBNAME>.] <SCHNAME>.<TABNAME>] [ALL]

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。
EXEC_NAME	EXEC模块的名称，对应配置文件中EXEC模块的“name”参数。
[<DBNAME>.] <SCHNAME>.<TABNAME>	数据库名.模式名.表名。查看指定表的跟踪信息，如果不指定，则查看所有表的跟踪信息。
ALL	配置该参数可查看分区子表信息。

命令示例

查看名称为“cpt_ora”的CPT模块的跟踪表信息。
```
show cpt_ora trace
```
查看结果为：

如果已设置TRX、LOB、SEND跟踪，则会显示TRX、LOB和SEND跟踪掩码。

查看结果为：
查看名称为“exec_dm”的EXEC模块跟踪表信息。
```
show exec_dm trace
```
查看结果为：

结果说明

参数	说明
ID	跟踪表ID。
数据库名	跟踪表所属的数据库名。
模式名	跟踪表所属的模式名。
表名	跟踪表的表名。
跟踪掩码	跟踪掩码。