1 简介
1.1 概念
dm_svc.conf 是使用DM数据库时非常重要的配置文件，它包含了 DM 各接口和客户端工具所需要配置的一些参数。通过他可以实现DM各种集群的读写分离和均衡负载，它必须和接口/客户端工具位于同一台机器上才能生效。
1.2 文件位置
dm_svc.conf 的工作目录是固定的，不能改变。用户如果需要将其修改并拷贝到其他客户端机器上 ， 也必须位于相同的目录中 。 dm_svc.conf 工作的目录就是初始dm_svc.conf 文件生成的目录。
初始 dm_svc.conf 文件由 DM 安装时自动生成。不同的平台生成目录有所不同。
- 32 位的 DM 安装在 Win32 操作平台下，此文件位于%SystemRoot%\system32目录；
- 64 位的 DM 安装在 Win64 操作平台下，此文件位于%SystemRoot%\system32目录；
- 32 位的 DM 安装在 Win64 操作平台下，此文件位于%SystemRoot%\SysWOW64目录；
- 在 Linux 平台下，此文件位于/etc 目录;
1.3 配置格式
dm_svc.conf 配置文件的内容分为全局配置区和服务配置区。全局配置区在前，可配置所有的配置项，服务配置区在后，以“[服务名]”开头，可配置除了服务名和WALLET_LOCATION 外的所有配置项。服务配置区中的配置优先级高于全局配置区（服务配置区的相同配置项会覆盖全局配置区对应的配置项）。
2 常用配置项
2.1 服务名
2.1.1 概念
用于连接的服务名，类似Oracle配置在tnsname.ora文件中的服务名，参数值格式为：
服务名=(IP[:PORT],IP[:PORT],......)。
2.1.2 应用举例
2.1.2.1 单机
1. 编辑dm_svc.conf文件，新增如下记录：
dm_windows_local=(127.0.0.1:5236)
2. 使用disql（或其他客户端）通过服务名dm_windows_local连接
D:\dmdbms\bin>disql test/testuserpwd@dm_windows_local
服务器[127.0.0.1:5236]:处于普通打开状态
登录使用时间 : 8.337(ms)
disql V8
SQL>
2.1.2.2 集群
1. 当使用数据守护集群时，可在括号里填写多个IP+端口，并以逗号分隔。例如：
dmdw=(192.168.11.132:5236,192.168.11.131:5236)
2. 使用disql（或其他客户端）通过服务名dmdw连接
[dmdba@localhost ~]$ disql SYSDBA/SYSDBA@dmdw
服务器[192.168.11.131:5236]:处于主库打开状态
2.2 外部用户密码存储
2.2.1 概念
使用DM提供的dmmkstore工具创建wallet文件来存储数据库连接凭据信息，以此方法来避免在命令行中输入账户或密码等敏感信息来连接数据库（不建议将具有很高权限的数据库账号信息保存在此文件中）。
2.2.2 应用举例
1. 创建wallet 文件
D:\dmdbms\bin>dmmkstore -wrl d:\data\dmw -create
2. 使用wallet创建库连接凭据
D:\dmdbms\bin>dmmkstore -wrl d:\data\dmw -createCredential dm_windows_local test testuserpwd
DM Secret Store Tool: 1-2-84-21.10.21-149328-10032-ENT
输入 Wallet 口令:
Create credential DM.security.client.connect_string1
3. 配置 dm_svc.conf 文件的wallet路径
WALLET_LOCATION=(d:\data\dmw)
4. 使用dm_svc.conf中wallet路径中的凭据登陆
D:\dmdbms\bin>disql /@dm_windows_local
2.3 压缩
2.3.1 概念
COMPRESS_MSG：是否启用消息压缩。0：不启用；1：启用
2.3.2 应用场景
当客户端和服务器通过外部较差的网络进行大量数据交换时，使用消息压缩对性能有一定提升。
2.4 超时
2.4.1 概念
CONNECT_TIMEOUT：连接超时时间，单位为毫秒。0 表示无限制
2.4.2 应用场景
- 网络较差希望等待更长时间避免连接超时导致连接失败。
- 应用处于网络稳定的环境，希望快速响应连接（以便集群环境可快速切换到其他服务器）。
2.5 读写分离
2.5.1 概念
RW_SEPARATE：是否启用读写分离（1、启用 0、不启用）
RW_PERCENT：将总事务的N%分发到主机执行（例如：当系统中读操作远远大于读操作时，可能导致主机资源的“饥饿”状态，无法充分利用服务器资源）
2.5.2 应用举例
针对DMDW集群开启读写分离功能，并且将25%的请求发送到主库
dmdw=(192.168.11.132:5236,192.168.11.131:5236)
[DMDW]
RW_SEPARATE=(1)
RW_PERCENT=(25)
注意：中括号中的DMDW表示该配置文件上下文中定义的服务名
2.6 节点选择模型
2.6.1 概念
EP_SELECTOR：连接数据库时采用何种模型建立连接。0：依次选取列表中的不同节点建立连接，使得所有连接均匀地分布在各个节点上；1：选择列表中最前面的节点建立连接，只有当前节点无法建立连接时才会选择下一个节点进行连接。
l 当设置为0时请求更为均衡
l 当设置为1时前面的服务器会更多的被连接
2.6.2 应用场景
- 当某些服务器配置更高、性能更好时，我们可能希望他能被更多使用
- 某些备用服务器性能较差，只做容灾考虑。
2.7 切换尝试次数
2.7.1 概念
SWITCH_TIMES：对服务器列表中的服务器尝试N次连接。
2.7.2 应用场景
- 网络稳定的环境中，希望尽快结束尝试（此时可能已经遭遇网络故障，需要及时维护）。
- 在网络不够稳定的环境中，希望进行多次重复尝试，尽量完成数据库的连接以完成工作。
2.8 切换服务等待时间（ms）
2.8.1 概念
SWITCH_INTERVAL：尝试切换下一个服务的时间间隔，单位为毫秒，默认值200ms。
- EP_SELECTOR设置为0，等待SWITCH_INTERVAL后会切换尝试连接下一个服务器。
- EP_SELECTOR设置为1，等待SWITCH_INTERVAL后会继续尝试连接该服务器，直到SWITCH_TIMES次再切换下一个服务器。
2.8.2 应用举例
例如：在第一个服务器尝试连接60次，每次尝试间隔1s后再切换连接下一个服务器。
SWITCH_TIMES=(60)
SWITCH_INTERVAL=(1000)
EP_SELECTOR=(1)
再如：在第一个服务器尝试连接失败并等待1s后，再切换连接列表中的下一个服务器，整个列表最多尝试60次。
SWITCH_TIMES=(60)
SWITCH_INTERVAL=(1000)
EP_SELECTOR=(0)
2.9 地址映射转发
2.9.1 概念
ADDRESS_REMAP：库地址重定向，将连接请求中的数据库重新定个方向转到其它数据库上。
2.9.2 应用场景
- 某些数据库服务器需要例行维护
- 某些数据库服务器出现故障
- 某些数据库服务器需要下线但希望尽可能不修改应用端的配置
2.9.3 应用举例
1. 修改dm_svc.cnf文件，增加如下记录
ADDRESS_REMAP =(dm, localhost:5236)
2. 使用客户端工具连接该服务器（配置文件中被重定向的服务器和端口值字面量值必须完全匹配，无法识别端口缺省值）
D:\dmdbms\bin>disql SYSDBA/SYSDBA@dm
服务器[localhost:5236]:处于普通打开状态
注意：配置文件中被重定向的服务器和端口值字面量值必须完全匹配，无法识别端口缺省值。
例如，沿用上述dm_svc.cnf中的配置，尝试以dm:5236连接数据库，将无法重定向到localhost:5236
修改dm_svc.cnf中的ADDRESS_REMAP：
ADDRESS_REMAP=(dm:5236, localhost:5236)
或者
ADDRESS_REMAP=(dm:5236, localhost)完成上述修改之后，再次使用以下命令尝试连接：
D:\dmdbms\bin>disql SYSDBA/SYSDBA@dm:5236 重定向连接成功
2.10 时区
2.10.1 概念
TIME_ZONE：指明客户端的默认时区，设置范围为：-779~840M，如 60 对应+1:00 时区
2.10.2 应用场景
- 当应用因为时区问题写入或读取的数据固定相差几个小时
https://eco.dameng.com/