达梦数据复制软件DMDRS同步环境准备指南：以SQL Server为源数据库

1 数据库准备工作

在运行DMDRS服务前，数据库管理员需要对数据库做如下准备工作。

配置服务	准备工作
源DMDRS	数据迁移场景，需要创建查询LSN辅助表。除数据迁移场景外，其他应用场景均需要设置源数据库的完整恢复模式和开启源数据库CDC功能。除数据迁移场景外，其他应用场景均需要配置DDL同步。创建源数据库同步用户DMDRS。配置源数据库同步用户最小权限。
目标DMDRS	创建目标数据库同步用户DMDRS。配置目标数据库同步用户最小用户权限。
DMDSS	无

1.1 设置源数据库的事务日志恢复模式

为了保证源DMDRS服务运行中数据的一致性，源DMDRS服务需要读源数据库的事务日志，因此源数据库需要设置为完整恢复模式。数据库管理员可按下列方式进行配置。

设置源数据库的事务日志恢复模式为完整恢复模式。

SQL> alter database <database_name> set recovery FULL;

1.2 开启源数据库CDC功能

为了同步更新操作，需要开启源数据库的CDC功能记录完整的更新操作信息。数据库管理员可执行如下SQL语句开启CDC功能。

开启库级CDC功能。

SQL> USE <database_name>
GO
EXEC sys.sp_cdc_enable_db
GO;

开启表级CDC功能。

EXEC sys.sp_cdc_enable_table 
@source_schema = <schema_name>, 
@source_name = <table_name>, 
@role_name = null,
@capture_instance = DEFAULT
GO；

说明
通过配置DMDRS的装载掩码CDC也可以开启源数据库的CDC功能。

1.3 配置DDL同步

DMDRS服务支持DDL同步功能。当应用场景中需要DDL同步时，数据库管理员可按触发器方式进行配置。

注意

创建DDL触发器前，必须先开启源数据库的库级CDC功能。

创建DDL触发器和辅助表时，请使用具有DBA权限的用户。

如果触发器或辅助表无效或缺失，会导致DDL同步失败，甚至会影响数据库。

在源数据库先执行“ddl_sql_mss_table.sql”脚本创建辅助表，再执行“ddl_sql_mss_trigger.sql”脚本创建触发器。脚本默认位置在DMDRS执行程序目录下的scripts子目录中。
1. 执行创建辅助表脚本。
```
SQL> r ddl_sql_mss_table.sql
```
2. 执行创建触发器脚本。
```
SQL> r ddl_sql_mss_trigger.sql
```

检查创建的辅助表和触发器是否有效。

检查创建的辅助表。

SQL> select su.name as user_name, sc.name as table_name from sys.sysobjects sc, sys.sysusers su where sc.name like 'DRS_$DDL%' and sc.xtype = 'U' and sc.uid = su.uid;

查询结果如下：

行号          user_name       table_name
----------   -----------   ----------------
1            SYSDBA        DRS_$DDL_COL
2            SYSDBA        DRS_$DDL_SQL
3            SYSDBA        DRS_$DDL_CONS
4            SYSDBA        DRS_$DDL_IDX
5            SYSDBA        DRS_$DDL_PART
6            SYSDBA        DRS_$DDL_OBJ
7            SYSDBA        DRS_$DDL_LSN
已用时间: 197.302(毫秒). 执行号:7.

如果存在以上查询结果，表示DMDRS辅助表创建成功。

检查创建的触发器。

SQL> select name as trigger_name from sys.triggers where name like 'DRS_$DDL_TRIGGER%' and type = 'TR'

查询结果如下：

行号               trigger_name
----------      ----------------
1               DRS_$DDL_TRIGGER_TABLE
2               DRS_$DDL_TRIGGER_INDEX
3               DRS_$DDL_TRIGGER_CONS
4               DRS_$DDL_TRIGGER_COL
已用时间: 12.147(毫秒). 执行号:16.

如果存在以上查询结果，表示DMDRS触发器创建有效。

1.4 创建数据库同步用户DMDRS

请源数据库管理员和目标数据库管理员分别创建数据库同步用户DMDRS，并赋予同步所需权限。建议源数据库DMDRS用户不赋予DBA权限，赋予同步所需的最小权限即可，建议目标数据库DMDRS用户赋予DBA权限，如果不能赋予DBA权限，为确保同步的正确性，需赋予DMDRS用户同步所需的最小权限，最小权限配置具体请参见3.5 配置数据库同步用户最小权限。

说明

如果数据库管理员已赋予DMDRS同步用户DBA权限，则不需要配置数据库同步用户最小权限。

数据库同步用户DMDRS创建完成后，如果需要在用户下进行DDL和DML操作，需要数据库管理员赋予相应的操作权限。

1.5 配置数据库同步用户最小权限

DMDRS服务运行过程中，使用的数据库同步用户需要一定的权限访问数据库数据，如果不能赋予DMDRS同步用户DBA权限，为确保同步的正确性，数据库管理员可根据应用场景配置数据库同步用户的最小权限。

1.5.1 源数据库同步用户最小权限

赋予SQL Server源数据库同步用户最小权限的脚本示例请参见 8.2.1 SQL Server源数据库同步用户最小权限脚本示例，具体的权限说明如下表所示。

权限类别	权限说明	权限
基础权限	SQL Server数据库用户默认具有PUBLIC角色权限。	PUBLIC
装载相关权限	装载时，数据库用户需要具有装载表的查询权限。如果待装载的表或序列在当前用户下，不需要额外赋予任何查询权限。如果待装载的表或序列在其他用户下，则需要赋予待装载表的查询权限。	需要赋予如下权限： SELECT ON <待装载表/序列的模式名>.<待装载表/序列的表名>
同步相关权限	源DMDRS创建辅助表和触发器的权限以及开启CDC权限。	需要赋予如下权限： EXEC sp_addrolemember 'db_ddladmin' ALTER ON SCHEMA::<目标模式>
	需要查询事务日志的权限。	VIEW SERVER STATE
	需要查询DBCC LOGINFO的权限。	EXEC sp_addsrvrolemember 'DMDRS', 'sysadmin'

1.5.2 目标数据库同步用户最小权限

SQL Server目标数据库同步用户最小权限

赋予SQL Server目标数据库同步用户最小权限的脚本示例请参见 8.2.2 SQL Server目标数据库同步用户最小权限脚本示例，具体的权限说明如下表所示。

权限类别	权限说明	权限
基础权限	目标DMDRS在执行DML时需要数据操作权限。	需要赋予如下权限: PUBLIC
	目标DMDRS在启动时需要在目标数据库中创建辅助表和辅助存储过程。	需要赋予如下权限： EXEC sp_addrolemember 'db_ddladmin' ALTER ON SCHEMA::<目标模式>
	目标DMDRS在启动时需要同步用户有创建会话的权限。	需要赋予如下权限: CONNECT
装载与同步相关权限	若需要同步在非同步用户模式下已存在的表/序列的数据，需要赋予在待同步表/序列上的DML权限或查询权限。	需要赋予如下权限: INSERT\|UPDATE\|DELETE ON <目标表的模式名>.<目标表名> SELECT ON <目标序列的模式名>.<目标序列名>
	若需要同步在非同步用户模式下未存在的表/序列的数据，可以先在装载时使用CREATE掩码同步创建表/序列DDL语句，然后赋予该表/序列的DML权限或查询权限。也可为同步用户赋予在所有表/序列上的DML权限或查询权限。	需要赋予如下权限： INSERT\|UPDATE\|DELETE\|SELECT ON SCHEMA::<目标模式名>
	若需要同步在非同步用户模式下的对象的DDL语句，需要赋予相应的DDL权限。	需要赋予如下权限： EXEC sp_addrolemember 'db_ddladmin' ALTER ON SCHEMA::<目标模式>

DM8目标数据库同步用户最小权限

赋予DM8目标数据库同步用户最小权限的脚本示例请参见 8.2.3 DM8目标数据库同步用户最小权限脚本示例，具体的权限说明如下表所示。

权限类别	权限说明	权限
基础权限	目标DMDRS在执行DML时需要数据操作权限。	需要赋予如下权限: PUBLIC
	目标DMDRS在启动时需要在目标数据库中创建辅助表和辅助存储过程。	需要赋予如下权限: RESOURCE
	目标DMDRS在启动时需要查询数据库的相关参数信息、系统表字典信息。	需要赋予如下权限: SOI、VTI
	目标DMDRS在启动时需要同步用户有创建会话的权限。	需要赋予如下权限: CREATE SESSION
装载与同步相关权限	若需要同步在非同步用户模式下已存在的表/序列的数据，需要赋予在待同步表/序列上的DML权限或查询权限。	需要赋予如下权限: INSERT\|UPDATE\|DELETE ON <目标表的模式名>.<目标表名> SELECT ON <目标序列的模式名>.<目标序列名>
	若需要同步在非同步用户模式下未存在的表/序列的数据，可以先在装载时使用CREATE掩码同步创建表/序列DDL语句，然后赋予该表/序列的DML权限或查询权限。也可为同步用户赋予在所有表/序列上的DML权限或查询权限。	需要赋予如下权限： INSERT\|UPDATE\|DELETE\|SELECT ANY TABLE SELECT ANY SEQUENCE
	若需要同步在非同步用户模式下表的注释，需要赋予创建表注释的权限。	需要赋予如下权限： COMMENT ANY TABLE
	若需要同步在非同步用户模式下的对象的DDL语句，需要赋予相应的DDL权限。注：装载表时需要赋予TABLE和INDEX的权限。授予ANY权限前，需先执行语句“ALTER SYSTEM SET 'ENABLE_DDL_ANY_PRIV'=1 BOTH;”开启ANY的授权权限。	需要赋予如下权限： CREATE\|ALTER\|DROP ANY <对象类型>
	若需要非模式对象（表空间、用户、角色和公共同义词）的DDL操作权限，需要赋予同步用户相应的DDL权限。其中角色和公共同义词不需要ALTER权限。	需要赋予如下权限： CREATE\|ALTER\|DROP <对象类型>
	若需要同步在非同步用户模式下的非表对象的DDL语句或源DMDRS的DDL_MASK配置SQL掩码情况下同步对象的DDL语句，需要赋予同步用户辅助存储过程的执行权限以及非同步用户下模式所属用户的存储过程的创建权限。	需要赋予如下权限： EXECUTE ON PROCEDURE "DRS_$DDL_SQL_PROC" CREATE PROCEDURE TO <非同步用户下模式所属的用户>

说明

对于旧版本DM8无SOI、VTI权限的情况，使用同等权限的对象查询权限即可。
SYS.V$DM_INI
V$IFUN
SYS.V$LOCK
SYS.V$SESSIONS

对于旧版本DM8无CREATE SESSION权限的情况，删除该权限即可。

1.6 创建查询LSN辅助表

在数据迁移场景，数据库管理员需执行脚本创建查询LSN辅助表。

注意

创建LSN辅助表时，请使用具有DBA权限的用户。

如果LSN辅助表无效或缺失，会导致数据迁移失败，甚至会影响数据库。

在源数据库执行“ddl_sql_mss_table.sql”脚本创建数据迁移所需的LSN辅助表，脚本默认位置在DMDRS执行程序目录下的scripts子目录中。

SQL> r ddl_sql_mss_table.sql

2 DMDRS准备工作

在配置和运行DMDRS服务前，需要对DMDRS做如下准备工作。

2.1 DMDRS服务管理规划

在配置DMDRS服务前，需规划DMDRS服务的Manager模块的端口号，包括源DMDRS、目标DMDRS服务和DMDSS服务的Manager模块的端口号。

注意
不同的应用场景，DMDRS所包括的DMDRS服务不同。如果在同一台服务器上部署不同的服务，必须确保这些服务的Manager模块的端口号的唯一性。

2.2 设置运行用户权限

说明
DMDRS的运行用户与安装用户使用同一个用户dmdrs，安装用户请参见《DMDRS安装手册》。

DMDRS运行用户需要以下权限：

Windows：运行用户具有管理员权限。
Linux/Unix系统：运行用户具有DMDRS服务所在目录及子目录的读、写和执行权限。源DMDRS的运行用户应同数据库归档文件目录属同一用户组，该用户组对归档文件所在目录及子目录有读权限。

2.3 设置环境变量

DMDRS服务运行过程中，需要使用数据库的驱动文件访问数据库数据。

源DMDRS服务：需要使用ODBC驱动文件访问SQL Server源数据库数据，用户需要在源DMDRS服务器的环境变量中添加ODBC驱动文件路径。
目标DMDRS服务：需要使用目标数据库对应的驱动文件访问目标数据库数据，用户需要在目标DMDRS服务器的环境变量中添加各数据库对应的驱动文件路径。

不同数据库对应的驱动如下所示。

SQL Server数据库：ODBC驱动
DM8数据库：DMDPI驱动

说明

设置环境变量前，请确保源DMDRS与目标DMDRS服务器上已安装数据库的驱动，且驱动版本与数据库版本相匹配。

设置环境变量前，请向数据库管理员获取数据库驱动路径。

由于操作系统、终端不同，设置环境变量命令或操作步骤会略有差异。

以设置SQL Server数据库的ODBC驱动的环境变量为例，介绍Windows操作系统下设置环境变量的方法。

在Windows桌面或“开始”菜单，右键单击“此电脑”，选择“属性”。
在打开的“设置”窗口中，选择“高级系统设置”。
在弹出的“系统属性”对话框的“高级”选项卡中，选择“环境变量”。
在“环境变量”对话框中，选择“系统变量”中系统变量“Path”，再选择“系统变量”下的“编辑”。
在“编辑环境变量”表格中，填写“ODBC驱动路径”。
重启服务器使环境变量配置生效。

以设置DM8数据库的DMDPI驱动的环境变量为例，介绍Linux/Unix系统操作系统下设置环境变量的方法。

Linux系统

在终端的配置文件中添加设置环境变量命令。
```
export LD_LIBRARY_PATH=<DMDPI驱动路径>:$LD_LIBRARY_PATH
```
Unix系统

在终端的配置文件中添加设置环境变量命令。
```
export LIBPATH=<DMDPI驱动路径>:$LIBPATH
```