6 同步

6.2 CPT模块命令

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

6.2.1 查看命令

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

6.2.1.1 查看统计信息

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块或对端模块的统计信息。

命令格式

• 命令格式一：

  查看第一个CPT模块和对端模块的统计信息。

  CPT
  

  说明

  • 数据同步场景，查看CPT模块的统计信息和EXEC模块对应的站点统计信息。
  • 数据分发场景，查看CPT模块的统计信息和DSS模块对应的消费者列表信息。

• 命令格式二：

  查看指定CPT模块的统计信息。

  SHOW [<CPT_NAME>] [STATE]
  

  说明

  命令格式中CPT_NAME和STATE至少需写其中一个。

  • 省略模块名，默认为查看第一个CPT模块的统计信息。
  • 省略state，默认为查看当前模块的统计信息。

参数说明

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

命令示例

• 在数据同步场景中，查看CPT模块和对端EXEC模块的统计信息。

  cpt
  

  查看结果为：

  

• 查看名称为“cpt_dm8”的CPT模块的统计信息。

  show cpt_dm8 state
  

  查看结果为：

  

结果说明

说明

EXEC站点统计信息的参数说明请参见6.3.1.1 查看统计信息章节。

参数	说明
IP地址	源DMDRS的IP地址。
管理端口号	Manager模块的端口号。
站点号	数据来源的站点号。
源库ID	源数据库的ID。
源库名	源数据库的名称。
CPT模块名称	当前CPT模块的名称。
CPT模块状态	当前CPT模块的状态。包括：CPT还未创建、CPT正在创建、CPT正在获取起始LSN、CPT正在初始化日志读取系统、CPT正在初始化字典、CPT正在初始化事务系统、CPT正在创建任务线程、CPT已经启动完成。
读取状态	当前读取过程的状态。包括：等待读取日志、提取SCN节点、日志排序、投递日志、日志队列已满、定位起始LSN、提取日志、空闲、包装日志、提取日志、互斥中、初始化准备、日志排序等待、读取日志、等待排序退出、等待日志分析完成、等待日志分析退出。
读取流量(MB)	读取日志的总流量（单位：MB）和实时速率（单位：MB/s）。
当前读取LSN	当前读取日志的LSN。
读取队列长度	CPT模块读取队列中的日志数量。
当前文件/当前目录	Oracle、MySQL/MariaDB数据库的参数为当前目录，其他数据库的参数为当前文件。 当前文件：当前读取的日志文件的名称。 当前目录：当前读取的日志文件的所在目录。
读取队列百分比(%)	当前CPT模块读取队列长度在最大读取队列长度中的占比。
解析状态	当前解析过程的状态。包括：分析退出、空闲、分解日志、组装日志、初始化准备、投递操作、等待子线程完成分析、等待发送线程完成投递。
解析流量(MB)	解析日志的总流量（单位：MB）和实时速率（单位：MB/s）。
当前解析LSN	当前解析日志的LSN。
解析队列长度	当前CPT模块解析队列中的日志数量。
过滤操作数	CPT模块解析过程中过滤掉的操作数。
解析队列百分比(%)	当前CPT模块解析队列长度在最大解析队列长度中的占比。
发送状态	当前发送过程的状态。包括：投递退出、空闲、等待日志、日志压缩、投递日志、准备语句、保存提交、保存事务、提交缓存、检查点、收集对象、部分回滚。
发送流量(MB)	发送日志的总流量（单位：MB）和实时速率（单位：MB/s）。
当前发送LSN	当前发送日志的LSN。
发送队列长度	当前CPT模块发送队列中的日志数量。
发送次数	当前CPT模块已经发送日志的次数。
发送队列百分比(%)	当前CPT模块发送队列长度在最大发送队列长度中的占比。
当前时间	CPT模块最后一次读取/解析/发送对应日志的日志生成时间。

6.2.1.2 查看表的操作统计信息

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块的操作时间前十的表或者所有表的操作统计信息，按操作时间由近至远排序，仅显示操作数大于0的表。也可按“模式名.表名”查看指定表的操作统计信息，可以显示操作数为0的表。该统计信息包括模式名、表名、插入/删除/更新的操作数、大对象操作数、LSN和最近操作时间。

命令格式

SHOW [<CPT_NAME>] TABLE [LIST|ALL|<SCHNAME>.<TABNAME>|<DICTID>]

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。
LIST|ALL|<SCHNAME>.<TABNAME><DICTID>	不配置该参数：查看所有表的操作统计信息。按操作时间由近至远排序，仅显示操作数大于0的表。 LIST：查看操作时间前十的表的操作统计信息。按操作时间由近至远排序，仅显示操作数大于0的表。 ALL：查看所有表的操作统计信息。按操作时间由近至远排序，仅显示操作数大于0的表。 <SCHNAME>.<TABNAME>：按模式名.表名查看指定表的操作统计信息。模式名和表名都支持模糊查询，具体如下： *：所有模式或表。 A*：前缀为A的所有模式或表。 *B：后缀为B的所有模式或表。 A*B：前缀为A且后缀为B的所有模式或表。 DICTID：按表ID查看指定表的操作统计信息。

命令示例

• 查看名称为“cpt_dm8”的CPT模块的所有表的操作统计信息。

  show cpt_dm8 table
  

  查看结果为：

  

• 查看名称为“cpt_dm8”的CPT模块中，模式名为“PERSON”、表名为“ADDRESS”的表的操作统计信息。

  show cpt_dm8 table PERSON.ADDRESS
  

  查看结果为：

  

结果说明

参数	说明
模式名	当前表所属的模式名。
表名	当前表的名称。
插入操作数	当前表进行插入操作的总次数。
删除操作数	当前表进行删除操作的总次数。
更新操作数	当前表进行更新操作的总次数。
大对象操作数	当前表进行大对象操作的总次数，包括：插入、更新和删除。Oracle源数据库只统计达到分片规模的大对象操作数。
最近LSN	当前表最近一次操作的LSN。
最近操作时间	当前表最近一次操作的时间。

6.2.1.3 查看读取日志信息

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块读取日志时的相关信息，如文件名、当前LSN、偏移量、读取流量和状态等。

说明

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

命令格式

SHOW [<CPT_NAME>] READ

参数说明

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

命令示例

查看名称为“cpt_dm8”的CPT模块读取日志时的相关信息。

show cpt_dm8 read

查看结果为：

结果说明

参数	说明
节点号	CPT模块当前读取的日志所属节点的节点号。
文件名/日志目录	Oracle、MySQL/MariaDB数据库的参数为日志目录，其他数据库的参数为文件名。 文件名：CPT模块当前读取的日志文件的名称。 日志目录：CPT模块当前读取的日志文件的所在目录。
当前LSN	CPT模块当前读取日志的LSN。
偏移量	CPT模块当前读取的日志的当前偏移量。
读取流量	读取日志的总流量和实时速率。
队列长度	CPT模块读取队列中日志数量。
当前时间	CPT模块当前读取日志的日志生成时间。
状态	CPT模块当前读取日志的状态。包括：等待读取日志、提取SCN节点、日志排序、投递日志、日志队列已满、定位起始LSN、提取日志、空闲、包装日志、提取日志、互斥中、初始化准备、日志排序等待、读取日志、等待排序退出、等待日志分析完成和等待日志分析退出。

6.2.1.4 查看解析日志信息

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块解析日志时的相关信息，包括单线程解析和多线程并行解析，如LSN信息、解析流量、解析队列长度、过滤操作数、解析时间和状态等。

说明

• 当源数据库为DM6、PostgreSQL和Kingbase时，不支持多线程并行解析。使用该命令时，不支持PARSE MAIN和PARSE CHILD参数。
• 该命令不适用于DB2源数据库。

命令格式

SHOW [<CPT_NAME>] PARSE|PARSE MAIN|PARSE CHILD

参数说明

参数	说明
CPT_NAME	CPT模块的名称，对应配置文件中CPT模块的“name”参数。
PARSE|PARSE MAIN|PARSE CHILD	PARSE：单线程解析时的信息。 PARSE MAIN：并行解析时的主线程信息。 PARSE CHILD：并行解析时的子线程信息。

命令示例

• 查看名称为“cpt_dm8”的CPT模块单线程解析日志时的相关信息。

  show cpt_dm8 parse
  

  查看结果为：

  

• 查看名称为“cpt_dm8”的CPT模块并行解析日志时主线程的相关信息。

  show cpt_dm8 parse main
  

  查看结果为：

  

• 查看名称为“cpt_dm8”的CPT模块并行解析日志时子线程的相关信息。

  show cpt_dm8 parse child
  

  查看结果为：

  

结果说明

• 单线程解析信息

  参数	说明
  起始LSN	CPT模块当前解析日志的起始LSN。
  当前LSN	CPT模块当前解析日志的LSN。
  终止LSN	CPT模块当前解析日志的终止LSN。
  解析流量	解析日志的总流量和实时速率。
  解析队列长度	CPT模块解析队列中的日志数量。
  日志队列长度	CPT模块当前待解析记录的数量。
  过滤操作数	CPT模块解析过程中过滤掉的操作数。
  当前时间	CPT模块解析当前日志的日志生成时间。
  状态	CPT模块当前解析日志的状态。包括：分析退出、空闲、分解日志、组装日志、初始化准备、投递操作、等待子线程完成分析和等待发送线程完成投递。

• 并行解析主线程信息

  参数	说明
  起始LSN	CPT模块当前解析日志的起始LSN。
  当前LSN	CPT模块当前解析日志的LSN。
  终止LSN	CPT模块当前解析日志的终止LSN。
  解析主线程流量	解析日志主线程的总流量和实时速率。
  解析队列长度	CPT模块解析队列中的日志数量。
  过滤操作数	CPT模块解析过程中过滤掉的操作数。
  当前时间	CPT模块主线程解析当前日志的日志生成时间。
  状态	CPT模块当前解析主线程的状态。包括：分析退出、空闲、分解日志、组装日志、初始化准备、投递操作、等待子线程完成分析和等待发送线程完成投递。

• 并行解析子线程信息

  参数	说明
  子线程ID	CPT模块解析子线程的ID。
  当前表	CPT模块解析子线程当前解析的表名。
  事务ID	CPT模块解析子线程当前解析的事务ID。
  当前LSN	CPT模块解析子线程解析的当前记录的LSN。
  解析子线程流量	解析日志子线程的总流量和实时速率。
  日志队列长度	CPT模块解析子线程待解析的记录数量。
  当前时间	CPT模块子线程解析当前日志的日志生成时间。
  状态	CPT模块当前解析日志子线程的状态。包括：分析退出、空闲、组装日志、投递操作和等待子线程完成分析。

6.2.1.5 查看发送日志信息

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块发送日志时的相关信息，如起始LSN、发送LSN、发送流量、发送队列长度、发送时间和状态等。

说明

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

命令格式

SHOW [<CPT_NAME>] SEND

参数说明

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

命令示例

查看名称为“cpt_dm8”的CPT模块发送日志时的相关信息。

show cpt_dm8 send

查看结果为：

结果说明

参数	说明
起始LSN	CPT模块当前发送的日志的第一条操作的LSN。
发送LSN	CPT模块当前发送的日志的最后一条操作的LSN。
发送流量	发送日志的总流量和实时速率。
发送队列长度	CPT模块发送队列中日志数量。
当前时间	CPT模块发送当前日志的日志生成时间。
状态	CPT模块当前发送日志的状态。包括：投递退出、空闲、等待日志、日志压缩、投递日志、准备语句、保存提交、保存事务、提交缓存、检查点、收集对象和部分回滚。

6.2.1.6 查看排序日志信息（仅支持DM8 DMDSC）

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块排序日志时的相关信息，如节点号、LSN、当前日志序号、排序流量、依赖节点信息、状态等。

命令格式

SHOW [<CPT_NAME>] SORT

参数说明

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

命令示例

查看名称为“cpt_dsc”的CPT模块排序日志时的相关信息。

show cpt_dsc sort

查看结果为：

结果说明

参数	说明
节点号	CPT模块当前排序的日志所属节点的节点号。
起始LSN	CPT模块开始排序日志时的起始LSN。
当前LSN	CPT模块当前排序日志的LSN。
当前日志序列号	CPT模块当前排序日志包的序列号。
日志链表长度	CPT模块排序完成队列中日志数量。
排序流量	CPT模块当前排序日志的速率。
依赖节点信息	CPT模块当前排序日志依赖的节点和LSN。
状态	CPT模块当前排序日志的状态。包括：排序退出、空闲、排序等待、包装日志、排序日志、互斥和投递。

6.2.1.7 查看拆分日志信息（仅支持DM8 DMDSC）

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块拆分日志时的相关信息，如LSN信息、当前日志序号、拆分链表长度、拆分流量、状态等。

命令格式

SHOW [<CPT_NAME>] UNPACK

参数说明

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

命令示例

查看名称为“cpt_dsc”的CPT模块拆分日志时的相关信息。

show cpt_dsc unpack

查看结果为：

结果说明

参数	说明
节点号	CPT模块当前合并的日志所属节点的节点号。
当前LSN	CPT模块当前合并日志的LSN。
添加LSN	CPT模块当前合并日志时添加的LSN。
当前日志序列号	CPT模块当前合并的日志包的序列号。
拆分链表长度	CPT模块合并完成队列中日志数量。
拆分流量	CPT模块将一个日志包拆分成多条日志的总流量。
状态	CPT模块当前合并日志的状态。包括：等待读取日志、提取SCN节点、日志排序、投递日志、日志队列已满、定位起始LSN、提取日志、空闲、包装日志、提取日志、互斥中、初始化准备、日志排序等待、读取日志、等待排序退出、等待日志分析完成和等待日志分析退出。

6.2.1.8 查看配置信息

适用场景

数据同步、数据分发

命令功能

查看指定CPT模块的全部或指定参数的配置信息，包括类别、配置项、配置值、默认值和配置说明。

命令格式

SHOW [<CPT_NAME>] CONF [<PARA_NAME>]

参数说明

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

命令示例

查看名称为“cpt_dm8”的CPT模块的全部配置信息。

show cpt_dm8 conf

查看结果为：