6 同步

6.2 CPT模块命令

CPT模块是源DMDRS服务的核心组成模块，主要实现源数据库的全量数据装载以及增量数据实时捕获、解析和投递。

6.2.1 查看命令

介绍CPT模块相关的查看命令。

6.2.1.9 查看离线字典的版本信息

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块中，按模式名.表名或表ID查看同步表的离线字典的版本信息，包括表ID、版本号、模式名、表名和当前版本最小LSN。

说明

• 按模式名.表名查看同步表的离线字典的全部版本信息时，表名应为该表最新版本的表名。
• 该命令不适用于DB2源数据库。

命令格式

SHOW [<CPT_NAME>] TABLE VERSION [<PDBNAME>.]<SCHNAME>.<DICTNAME>|<DICTID>

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。
[<PDBNAME>.]<SCHNAME>.<DICTNAME>|<DICTID>	[<PDBNAME>.]<SCHNAME>.<DICTNAME>：离线字典容器名.模式名.离线字典表名，容器名仅适用于容器数据库。容器名、模式名和表名都支持模糊查询，具体如下： *：所有容器、模式或表。 A*：前缀为A的所有容器、模式或表。 *B：后缀为B的所有容器、模式或表。 A*B：前缀为A且后缀为B的所有容器、模式或表。 DICTID：离线字典表ID 。 当指定模糊匹配参数时，只打印第一张匹配到的表结构信息。

命令示例

查看名称为“cpt_dm8”的CPT模块中，表ID为“1423”的离线字典的全部信息。

show cpt_dm8 table version 1423

查看结果为：

结果说明

参数	说明
表ID	离线字典表ID。
版本号	离线字典的版本号。
模式名	离线字典当前版本号对应的模式名。
表名	离线字典当前版本号对应的表名。
当前版本最小LSN	离线字典当前版本号对应的最小LSN。

6.2.1.10 查看离线字典的表结构

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块中，按模式名.表名或表ID查看指定版本号或最新版本号的同步表的离线字典的表结构信息，如列ID、列名、数据类型、精度、标度、列掩码、主键列和默认值等。

说明

该命令不适用于DB2源数据库。

命令格式

SHOW [<CPT_NAME>] TABLE ATTR [ALL] [<PDBNAME>.]<SCHNAME>.<DICTNAME>|<DICTID> [VERSION <VERSION NUMBER>]

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。
ALL	离线字典的全部表结构信息。配置该参数可以显示同步表的离线字典的全部表结构信息，包含列掩码、主键列和默认值三个参数项。不配置该参数，则不显示列掩码、主键列和默认值。
[<PDBNAME>.]<SCHNAME>.<DICTNAME>|<DICTID>	[<PDBNAME>.]<SCHNAME>.<DICTNAME>：离线字典容器名.模式名.离线字典表名，容器名仅适用于容器数据库。容器名、模式名和表名都支持模糊查询，具体如下： *：所有容器、模式或表。 A*：前缀为A的所有容器、模式或表。 *B：后缀为B的所有容器、模式或表。 A*B：前缀为A且后缀为B的所有容器、模式或表。 DICTID：离线字典表ID 。 当指定模糊匹配参数时，只打印第一张匹配到的表结构信息。
VERSION NUMBER	离线字典的版本号。查看指定版本号的离线字典表结构信息，未配置该参数时默认显示最新版本的离线字典表结构信息。

命令示例

• 查看名称为“cpt_dm8”的CPT模块中，模式名为“PERSON”、表名为“ADDRESS”的同步表的离线字典的最新版本的表结构信息。

  show cpt_dm8 table attr PERSON.ADDRESS
  

  查看结果为：

  

• 查看名称为“cpt_dm8”的CPT模块中，模式名为“PERSON”、表名为“ADDRESS”的同步表的离线字典的版本号为1的表结构信息。

  show cpt_dm8 table attr PERSON.ADDRESS version 1
  

  查看结果为：

  

• 查看名称为“cpt_dm8”的CPT模块中，模式名为“PERSON”、表名为“ADDRESS”的同步表的离线字典的版本号为2的表结构信息。

  show cpt_dm8 table attr PERSON.ADDRESS version 2
  

  查看结果为：

  

• 查看名称为“cpt_dm8”的CPT模块中，模式名为“PERSON”、表名为“EMPLOYEE”的同步表的离线字典的全部表结构信息。

  show cpt_dm8 table attr all PERSON.EMPLOYEE
  

  查看结果为：

  

结果说明

参数	说明
列ID	该字典表结构对应的列ID。
列名	列ID对应列的名称。
数据类型	该列数据的类型。
精度	数字的位数。
标度	数据小数点后的数字位数。
允许为空	该列数据是否允许为空。
列掩码	该列的列属性掩码。
主键列	是否为主键列。
默认值	该列的默认值。

6.2.1.11 查看或检测离线字典文件

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块的所有离线字典文件的相关信息，或者按模式名.表名或表ID查看指定离线字典文件的相关信息，如文件名、模式名、表名、LSN和DDL时间等。

当配置CHECK参数时，可将当前离线字典的信息与数据库中该表的属性进行比较。

命令格式

SHOW [<CPT_NAME>] DICT [<CHECK>] ALL|SYNC|[<PDBNAME>.]<SCHNAME>.<DICTNAME>|<DICTID>

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。
CHECK	字典检测参数。配置后会将当前离线字典的表信息、列信息和分区信息与数据库中该表的相关属性进行比较，查看两者是否一致。
ALL|SYNC|[<PDBNAME>.]<SCHNAME>.<DICTNAME>|<DICTID>	ALL：所有离线字典表信息。如果检测所有离线字典文件时，不需要配置ALL。 SYNC：通过同步生成的离线字典表信息。 [<PDBNAME>.]<SCHNAME>.<DICTNAME>：离线字典容器名.模式名.离线字典表名。支持指定多个查询条件，其中每个条件之间按|号分隔。容器名仅适用于容器数据库。容器名、模式名和表名都支持模糊查询，具体如下： *：所有容器、模式或表。 A*：前缀为A的所有容器、模式或表。 *B：后缀为B的所有容器、模式或表。 A*B：前缀为A且后缀为B的所有容器、模式或表。 DICTID：离线字典表ID 。

命令示例

• 查看名称为“cpt_dm8”的CPT模块的所有离线字典文件的相关信息。

  show cpt_dm8 dict all
  

  查看结果为：

  

• 查看名称为“cpt_dm8”的CPT模块中，模式名为“PERSON”、表名为“PERSON”的离线字典文件的相关信息。

  show cpt_dm8 dict PERSON.PERSON
  

  查看结果为：

  

• 查看并检测名称为“cpt_dm8”的CPT模块的所有离线字典文件的相关信息。

  show cpt_dm8 dict check
  

  查看结果为：

  

• 查看并检测名称为“cpt_dm8”的CPT模块中，模式名为“PERSON”、表名为“PERSON”的离线字典文件的相关信息。

  show cpt_dm8 dict check PERSON.PERSON
  

  查看结果为：

  

结果说明

参数	说明
ID	离线字典表ID。
文件名	离线字典文件名。
模式名	离线字典模式名。
表名	离线字典表名。
LSN	离线字典LSN。
DDL时间	离线字典进行DDL操作的时间。
节点信息	离线字典所属节点的节点号和节点LSN，单机模式下无该信息。
是否正确	配置CHECK参数后，离线字典信息是否与数据库中表属性一致。 YES：离线字典信息与数据库中表属性一致。 NO：离线字典信息与数据库中表属性不一致。
错误信息	配置CHECK参数后，离线字典信息与数据库中表属性不一致的内容。

6.2.1.12 查看归档/在线日志文件

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块的所有归档日志，如文件名、日志序列号、时间、文件大小、状态等或在线日志文件的相关信息，如文件名、归档时LSN、偏移量等。

说明

该命令不适用于DB2源数据库。

命令格式

SHOW [<CPT_NAME>] LOG ARCH|ONLINE [<NUM>]

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。
ARCH|ONLINE	ARCH：归档日志文件信息。 ONLINE：在线日志文件信息。
NUM	指定显示日志的数量，按日志序列号递减，即按指定数量显示最新的日志文件信息。

命令示例

• 查看名称为“cpt_dm8”的CPT模块的所有归档日志文件的相关信息（DM8）。

  show cpt_dm8 log arch
  

  查看结果为：

  

• 查看名称为“cpt_dm8”的CPT模块的所有在线日志文件的相关信息（DM8）。

  show cpt_dm8 log online
  

  查看结果为：

  

结果说明

• 归档日志文件信息（DM7/DM8）

  参数	说明
  节点号	归档日志文件所属节点的节点号。
  文件名	归档日志的文件名。
  日志序列号	归档日志的序列号。
  日志LSN	归档日志的LSN。
  开始时间	/
  结束时间	/
  文件大小（MB）	归档日志的大小。
  状态	归档日志的状态（针对数据库）。包括：已归档、活动。

• 在线日志文件信息（DM7/DM8）

  参数	说明
  节点号	在线日志文件所属节点的节点号。
  文件名	在线日志的文件名。
  归档时LSN	在线日志归档的LSN。
  偏移量	在线日志的当前读取偏移量。

• 归档日志文件信息（Oracle）

  参数	说明
  节点号	归档日志文件所属节点的节点号。
  文件路径	归档日志存储的路径。
  日志序列号	归档日志的序列号。
  日志LSN	归档日志的LSN。
  开始时间	归档日志创建的时间。
  结束时间	归档日志最后修改的时间。
  文件大小	归档日志的大小。
  状态	归档日志的状态（针对数据库）。包括：已归档、活动。

• 在线日志文件信息（Oracle）

  参数	说明
  节点号	在线日志文件所属节点的节点号。
  文件路径	在线日志存储的路径。
  归档时LSN	在线日志归档的LSN。
  偏移量	在线日志的当前读取偏移量。

• 归档日志文件信息（PostgreSQL/Kingbase）

  参数	说明
  文件名	归档日志的文件名。
  起始LSN	归档日志的起始LSN。
  结束LSN	归档日志的结束LSN。
  文件大小	归档日志的大小。

• 在线日志文件信息（PostgreSQL/Kingbase）

  参数	说明
  文件名	在线日志的文件名。
  归档时LSN	在线日志归档的LSN。
  偏移量	在线日志的当前读取偏移量。

6.2.1.13 查看事务信息

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块的事务信息，包括事务数量、事务ID、起始LSN、事务开始时间、首个DBA、操作ID和DBA路径。

说明

• DM8、MySQL/MariaDB数据库无事务信息。
• 该命令不适用于DB2数据库。

命令格式

SHOW [<CPT_NAME>] TRX

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。

命令示例

查看名称为“cpt_ora”的CPT模块的事务信息（Oracle）。

show cpt_ora trx

查看结果为：

结果说明

参数	说明
事务数量	CPT模块事务的数量。
事务ID	CPT模块事务的ID。
起始LSN	CPT模块事务的起始LSN。
事务开始时间	CPT模块事务的开始时间。
首个DBA	CPT模块事务的首个DBA。
操作ID	CPT模块事务的操作ID。
DBA路径	CPT模块事务的DBA路径。

6.2.1.14 查看检查点信息

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块当前检查点信息，如检查点状态、日志LSN和检查点时间。

说明

MySQL/MariaDB数据库无检查点信息。

命令格式

SHOW [<CPT_NAME>] CKPT

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。

命令示例

查看名称为“cpt_dm8”的CPT模块当前检查点的相关信息。

show cpt_dm8 ckpt

查看结果为：

结果说明

参数	说明
检查点状态	CPT模块当前检查点的状态。包括：获取源数据库LSN、保存DBA信息、保存TRX信息、保存DDL操作、保存检查点SCN和空闲。
日志LSN	CPT模块当前检查点的LSN。
检查点时间	CPT模块当前检查点的时间。

6.2.1.15 查看存储空间信息

适用场景

数据迁移、数据同步、数据分发

命令功能

查看指定CPT模块当前实例占用存储空间信息，如实例文件夹、LOG文件夹、DICT文件夹、事务文件夹、DDL文件夹、CACHE文件夹的大小等。

说明

该命令不适用于DB2源数据库。

命令格式

SHOW [<CPT_NAME>] STOR

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。

命令示例

查看名称为“cpt_dm8”的CPT模块当前实例占用存储空间信息。

show cpt_dm8 stor

查看结果为：

结果说明

参数	说明
实例文件夹大小	CPT模块当前实例所占用的存储空间大小。
LOG文件夹大小	CPT模块当前实例使用的LOG文件夹存储空间大小。
ERRLOG文件夹大小	CPT模块当前实例使用的ERRLOG文件夹存储空间大小。
DICT文件夹大小	CPT模块当前实例使用的DICT文件夹存储空间大小。
事务文件夹大小	CPT模块当前实例使用的事务文件夹存储空间大小。
DDL文件夹大小	CPT模块当前实例使用的DDL文件夹存储空间大小。
CACHE文件夹大小	CPT模块当前实例使用的CACHE文件夹存储空间大小。

6.2.1.16 查看数据库连接信息

适用场景

数据迁移、数据同步、数据分发

命令功能

查看指定CPT模块当前数据库的连接信息，包括数据库类型、会话ID、登录用户和连接时间等。

说明

该命令不适用于DB2源数据库。

命令格式

SHOW [<CPT_NAME>] DATABASE CONNECT

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。

命令示例

查看名称为“cpt_dm8”的CPT模块当前数据库连接的相关信息。

show cpt_dm8 database connect

查看结果为：

结果说明

参数	说明
当前连接数	当前CPT的数据库连接数。
最大连接数	CPT允许的最大数据库连接数。
编号	数据库连接序号。
数据库类型	数据库类型。
会话ID	数据库连接的SESSIONID。
登录用户	数据库连接用户名。
SERVER	数据库连接服务。
端口	数据库连接端口。
连接时间	数据库连接创建的时间。
文件名	数据库连接创建的源文件名。
行号	数据库连接创建的文件行号。

6.2.1.17 查看连接对端DMDSS集群信息

命令功能

查看指定CPT模块当前所连接DSS模块所在DMDSS集群的各节点信息。

说明

该命令不适用于DB2源数据库。

命令格式

SHOW [<CPT_NAME>] DSS CLUSTER

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。

命令示例

查看名称为“cpt_ora”的CPT模块所连接的DSS主备集群的各节点信息。

show cpt_ora dss cluster

查看结果为：

结果说明

参数	说明
状态	集群各节点的状态。 Leader：主节点 Follower：备节点 Candidate：选举中 Disconnect：网络连接丢失的节点
IP和端口	节点的IP地址和Manager模块的端口号。
站点号	节点的站点号。
模块名	节点的模块名。
连接状态	当前连接：当前CPT模块与该节点已连接。 -：当前CPT模块与该节点未连接。