达梦数据复制软件DMDRS控制台命令-DSS模块操作命令

6 同步

6.4 DSS模块命令

DSS模块是DMDSS服务的核心组成模块，可接收CPT模块发送的数据，并根据Topic主题将同步消息分类流式持久化存储在不同的Topic中，供下一级数据同步服务访问使用。

适用场景

数据分发

6.4.2 操作命令

介绍DSS模块相关的操作命令。

6.4.2.1 开启表的操作统计信息监控

命令功能

开启DSS模块的表操作统计信息监控。为了节省内存占用率，DSS模块默认关闭表操作统计信息监控，开启后才可以监控到表操作。

命令格式

SET <DSS_NAME> TABLE MONITOR ON|OFF

参数说明

参数	说明
DSS_NAME	DSS模块的名称，对应配置文件中DSS模块的“name”参数。
ON\|OFF	ON：开启表操作统计信息监控。 OFF：关闭表操作统计信息监控。

命令示例

开启名称为“dss_active”的DSS模块的表的操作统计信息监控。

set dss_active table monitor on

6.4.2.2 解析DSS日志流并打印到本地

命令功能

为方便对DSS的数据流进行监控，DSS支持将日志流文件解析为SQL语句存放在文件中。该命令从指定的LSN区间获取DSS模块的生产者的日志，并打印保存到指定文件夹。

命令格式

DUMP <DSS_NAME> <SAVE_NAME> [LSN MIN <MIN_LSN>] [LSN MAX <MAX_LSN>] [TABLE <SCHNAME>.<TABLENAME>] [FILE "<PATH>"]

注意
此命令必须通过CSL执行，实际为CSL从DSS获取日志后在CSL进行打印操作，因此在执行中途关闭CSL会导致打印停止。

参数说明

参数	说明
DSS_NAME	DSS模块的名称，对应配置文件中DSS模块的“name”参数。
SAVE_NAME	生产者的名称（对应CPT模块的名称）。
MIN_LSN	待打印日志的起始LSN。若不输入，则将从储存流中的最小LSN开始打印。
MAX_LSN	待打印日志的结束LSN。若不输入，则表示一直打印到最新LSN，输入打印停止命令（dump stop）才会停止打印。
<SCHNAME>.<TABNAME>	模式名.表名。模式名和表名都支持模糊查询，具体如下：：所有模式或表。 A：前缀为A的所有模式或表。 B：后缀为B的所有模式或表。 AB：前缀为A且后缀为B的所有模式或表。
FILE "<PATH>"	打印日志文件的保存路径。默认保存路径为软件安装目录的console文件夹下的cpt_dm8_dss_log_to_sql文件夹中。

命令示例

从起始LSN为0处开始打印模块名为“dss_active”的生产者名称为“cpt_dm8”的日志。日志默认保存路径为软件安装目录的console文件夹下的cpt_dm8_dss_active_log_to_sql文件夹中。日志文件是txt格式，每个文件大小为200MB。
```
dump dss_active cpt_dm8
```
打印模块名为“dss_active”的生产者名称为“cpt_dm8”的日志，日志的LSN范围为985420～1000000，只打印有关"RESOURCES.EMPLOYEE_DEPARTMENT"表的日志，日志保存路径为"f:"。日志文件为txt格式，每个文件大小为200MB。
```
dump dss_active cpt_dm8 lsn min 985420 lsn max 1000000 table RESOURCES.EMPLOYEE_DEPARTMENT file "f:\"
```
停止打印。
```
dump stop
```

6.4.2.3 修改DMDSS初始化集群节点

命令功能

修改DMDSS初始化集群节点。

命令格式

ALTER [<DSS_NAME>] CLUSTER SET INITIAL CLUSTER EMPTY|<IP>:<PORT>/<NAME>[,<IP>:<PORT>/<NAME>,...]

参数说明

参数	说明
DSS_NAME	DSS模块的名称，对应配置文件中DSS模块的“name”参数。
EMPTY	清空初始化集群节点。
<IP>:<PORT>/<NAME>	DMDSS节点的IP地址:DMDSS节点的Manager模块的端口号/DMDSS节点的模块名。

命令示例

修改名称为“dss_cluster”的DSS模块的DMDSS初始化集群节点为3个节点的集群。

alter dss_cluster cluster set initial cluster 192.168.20.25:5345/dss_active,192.168.20.26:5345/dss_standby_1,192.168.20.27:5345/dss_standby_2

清空名称为“dss_cluster”的DSS模块内设置的DMDSS初始化集群节点。
```
alter dss_cluster cluster set initial cluster empty
```

6.4.2.4 修改DMDSS为集群模式

命令功能

将DMDSS单机模式节点修改为集群模式。

命令格式

ALTER [<DSS_NAME>] CLUSTER ENABLE

参数说明

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

命令示例

修改名称为“dss_cluster”的DSS模块为集群模式。

alter dss_cluster cluster enable

6.4.2.5 修改DMDSS为单机模式

命令功能

将DMDSS集群模式节点修改为单机模式。

命令格式

ALTER [<DSS_NAME>] CLUSTER DISABLE [CLEAR]

参数说明

参数	说明
DSS_NAME	DSS模块的名称，对应配置文件中DSS模块的“name”参数。
CLEAR	清理集群相关缓存文件，清理后重新修改节点为集群模式后可以重新初始化节点。

命令示例

修改名称为“dss_cluster”的DSS模块为单机模式。
```
alter dss_cluster cluster disable
```
修改名称为“dss_cluster”的DSS模块为单机模式，并清理集群缓存文件。
```
alter dss_cluster cluster disable clear
```

6.4.2.6 修改DMDSS集群节点

命令功能

添加或删除DMDSS集群节点。

注意
必须在主节点上执行该命令，否则命令不会生效。执行该命令前，可以使用查看DMDSS集群信息命令查看集群各节点信息。

命令格式

ALTER [<DSS_NAME>] CLUSTER ADD|DELETE NODE <IP>:<PORT>/<NAME>

参数说明

参数	说明
DSS_NAME	DSS模块的名称，对应配置文件中DSS模块的“name”参数。
ADD\|DELETE	ADD：添加DMDSS节点。 DELETE：删除DMDSS节点。
<IP>:<PORT>/<NAME>	DMDSS节点的IP地址:DMDSS节点的Manager模块的端口号/DMDSS节点的模块名。

命令示例

为名称为“dss_cluster”的DSS模块所在DMDSS集群添加节点，节点的IP地址为192.168.20.28，节点的Manager模块的端口号为5345，节点的模块名为dss_standby。
```
alter dss_cluster cluster add node 192.168.20.28:5345/dss_standby
```
为名称为“dss_cluster”的DSS模块所在DMDSS集群删除节点，节点的IP地址为192.168.20.28，节点的Manager模块的端口号为5345，节点的模块名为dss_standby。
```
alter dss_cluster cluster delete node 192.168.20.28:5345/dss_standby
```