数据库服务名配置示例

目前达梦的服务名配置执行dm_svc.conf文件的方式及URL中直接配置的方式，同时根据不同的数据库架构，如单机、主备、DSC、DSC主备等场景，配置参数上又会有些许差异。下面针对这些架构的数据库及集群，提供配置示例，示例中的服务名xxdb可以自定义，建议为系统简称。

1.单机数据库服务名配置

单机环境，只对应一台数据库服务器。

1.1 dm_svc.conf文件配置示例如下：

在需要连接数据库的应用服务器上保存dm_svc.conf文件，文件内容：

xxdb=(数据库IP:连接端口) 
TIME_ZONE= (480)
LANGUAGE=(CN)

dm_svc.conf文件可以放到自己指定的位置，jdbc url中写绝对路径即可，连接串配置如下:

jdbc:dm://xxdb?dmsvcconf=/xxx/xxx/dm_svc.conf
username: xxx
passwd:   xxx

达梦驱动默认会读取/etc/dm_svc.conf，所以直接放到/etc目录下也可，需要赋予755权限

1.2 应用URL配置示例如下：

jdbc:dm://xxdb?xxdb=数据库IP:端口

2.主备集群服务名配置

在主备集群的高可用环境中，应用可通过dm_svc.conf文件或者URL中配置主备模式，连接数据库服务名可实现高可用，主库一旦发生宕机，备库自动接管，应用可自动连接到新的主库。

2.1 dm_svc.conf配置示例如下：

在需要连接数据库的应用服务器上保存dm_svc.conf文件，文件内容：
（根据实际数据库节点数量添加IP端口信息）

xxdb=(主库IP:端口,备库1IP:端口,备库2IP:端口) 
TIME_ZONE= (480)
LANGUAGE=(CN)
[xxdb]
LOGIN_MODE=(1) --只连接主库，达梦驱动连接数据库的时候会对上面配置的多个IP发一个探测，只连接主库，若发生了主备切换，则再次探测新的主库建立连接。
SWITCH_TIMES=(60) --无法正常连接时，服务名遍历次数，可根据实际情况调整
SWITCH_INTERVAL=(1000)  --无法正常连接时，配置的服务器IP间切换的时间间隔，单位ms，可根据实际情况调整

dm_svc.conf文件可以放到自己指定的位置，jdbc url中写绝对路径即可，连接串配置如下:

jdbc:dm://xxdb?dmsvcconf=/xxx/xxx/dm_svc.conf
username: xxx
passwd:   xxx

达梦驱动默认会读取/etc/dm_svc.conf，所以直接放到/etc目录下也可，需要赋予755权限

2.2 URL中配置主备模式配置示例如下：

在需要连接数据库的应用URL中配置如下内容：
（根据实际数据库节点数量添加IP端口信息）

jdbc:dm://xxdb?xxdb=(主库IP:5236,备库1IP:5236)&loginMode=1&switchTimes=60&switchInterval=1000
username: xxx
passwd:   xxx

配置中的参数含义解释同2.1，但需要注意的是URL配置时，参数名为驼峰型写法，不符合写法要求的参数配置无法识别生效。

3.DSC集群服务名配置

DSC集群可配置可分为两类，分别为DSC集群及DSC主备集群环境，应用可通过配置dm_svc.conf文件或者URL后，连接数据库服务名可实现高可用，DSC控制节点一旦发生宕机，其余DSC节点可自动接管，应用可自动连接到新的控制节点。

3.1 dm_svc.conf配置示例如下：

在需要连接数据库的应用服务器上保存dm_svc.conf文件，文件内容：
（1）节点信息根据实际数据库节点数量添加IP端口信息。
（2）如果只是DSC集群非主备模式，则不需要配置备库IP及LONG_MODE参数

xxdb=(DSC节点1IP:5236,DSC节点2IP:5236,备库1IP:5236) 
TIME_ZONE= (480)
LANGUAGE=(CN)
[xxdb]
LOGIN_MODE=(1) --DSC主备集群下需要配置，只是单独的DSC集群无需配置
SWITCH_TIMES=(60) --无法正常连接时，服务名遍历次数，可根据实际情况调整
SWITCH_INTERVAL=(1000)  --无法正常连接时，配置的服务器IP间切换的时间间隔，单位ms，可根据实际情况调整
CLUSTER=(DSC) --标注连接的集群类型为DSC
AUTO_RECONNECT=(2)
LOGIN_DSC_CTRL=(1)  --配置DSC数据库连接是否只连主控节点。可根据业务场景判断，如果业务中存在大量的数据增删改的情况，可配置只连接主控节点，减少DSC节点间的数据页争用，提高处理效率

dm_svc.conf文件可以放到自己指定的位置，jdbc url中写绝对路径即可，连接串配置如下:

jdbc:dm://xxdb?dmsvcconf=/xxx/xxx/dm_svc.conf
username: xxx
passwd:   xxx

达梦驱动默认会读取/etc/dm_svc.conf，所以直接放到/etc目录下也可，需要赋予755权限

3.2 URL中配置示例如下：

在需要连接数据库的应用URL中配置如下内容：
（1）节点信息根据实际数据库节点数量添加IP端口信息。
（2）如果只是DSC集群非主备模式，则不需要配置备库IP及LONG_MODE参数

jdbc:dm://xxdb?xxdb=(DSC节点1IP:5236,DSC节点2IP:5236,备库1IP:5236)&loginMode=1&switchTimes=60&switchInterval=1000&cluster=DSC&epSelector=1&loginDscCtrl=1&autoReconnect=2
username: xxx
passwd:   xxx

配置中的参数含义解释同2.1，但需要注意的是URL配置时，参数名为驼峰型写法，不符合写法要求的参数配置无法识别生效。