特别说明：数据库代理包已经发布2.0版本，请大家前往下面路径获取

https://vip.kingdee.com/article/294757094505722880 

1 简介

使用集成服务云，首先配置需要集成的集成系统的连接信息，用户可以在连接配置界面选择数据库代理类型并填写目标数据库的相关信息。

1.1 功能介绍

通过连接配置，完成配置数据库代理类型的连接配置。

功能列表：新增、删除、测试、网络检查、事件绑定、触发日志、异常通知配置和获取当前账套信息等功能。

1.2 应用场景

集成服务云需要与数据库集成，但是数据库不允许直连暴露在外网，所以采用数据库代理模式。

1.3 系统路径

【集成管理】→【连接管理】→【连接配置】

1.4 字段/按钮说明

字段说明：

按钮说明：

2 主要操作

2.1  部署

步骤1：获取集成云数据库代理包DB_PROXY(见文章底部附件)。

步骤2： 将数据库代理包DB_PROXY部署能够访问相应数据库的服务器上，另外苍穹服务器需要能访问代理服务器即部署代理包的服务器。

步骤3： 配置数据库连接，修改文件 database.ini (DB_PROXY\webapps\isc\WEB-INF)。

 sqlserver样例:

 单个库

多个库

mysql样例：

[
 {
     name: 'meta',
     type: 'mysql2',
     sql_database: 'life',
     max_connections: 50,
     server_name: '192.168.1.98',
     server_port: 3306,
     user_name: 'root',
     password: 'XXXXXX',
     charset: 'utf8',
     server_timezone: 'Asia/Shanghai',
     factory: 'kd.isc.connector.trd.MySqlDatabaseFactory'
  }
]

oracle样例：

[
 {
     name: 'meta',
     type: 'oracle2',
     ora_service: 'orcl',
     max_connections: 50,
     server_name: '192.168.1.98',
     server_port: 1521,
     user_name: 'life',
     password: 'XXXXX',
     factory: 'kd.isc.connector.trd.OracleDatabaseFactory'
  }
]

步骤4：获取苍穹连接配置（数据库代理）的访问键，修改文件connector.ini(DB_PROXY\webapps\isc\WEB-INF)，DB值为刚刚获取的访问键。（如何新增连接配置，参照文章后面的连接配置新增操作步骤）

单个库

多个库

数据库表的读写权限配置，.+ 默认是所有表。

注意：name 可以根据现场情况自定义命名，但是需要跟连接配置页面的“数据库名”保持一致，如下图的蓝色框。

步骤5：修改文件启动TOMCAT.bat（DB_PROXY/）,设置JRE_HOME为本地路径。

注：JDK版本建议1.8。

步骤6：启动Tomcat服务，双击TOMCAT.bat（DB_PROXY/），出现字样“DatabaseInitiator end successfully！”说明启动成功。

2.2  新增连接配置

点击“新增”按钮，输入相关信息后点击保存按钮。

注：如需开启反调代理用户校验，可参考反调校验

服务器端口：Tomcat端口，默认为9983。（文件server.xml DB_PROXY\conf\ 中的connector port值）

数据库名：需要集成的数据库名（文件 database.ini DB_PROXY\webapps\isc\WEB-INF 的 name值）

注：

1. oracle中数据库表名必须大写，集成服务云才支持同步，但可以通过在oracle创建视图的方式避开此限制。建议字段名、表名、视图名都大写。

2. 考虑数据库的普通用户没有CREATE TABLE权限，在程序中会报拒绝创建表权限如：

3. 以下表临时表需要DELETE/UPDATE/INSERT/SELECT权限

//说明暂存表主表T_ISCB_TMP_MAIN，记录调用id，暂存结果表T_ISCB_TMP_RETURNS每次保存前先检查该表有没有数据,
//MYSQL数据库建表语句
CREATE TABLE T_ISCB_TMP_MAIN(fid varchar(32)  not null, ftime datetime not null, CONSTRAINT PK_ISCB_TMP_MAIN primary key(fid));
CREATE TABLE T_ISCB_TMP_RETURNS(fid varchar(32) not null, fseq integer not null, fdata longblob not null, ftime datetime not null, fhasmore char(1) not null, CONSTRAINT PK_ISCB_TMP_RETURNS primary key(fid,fseq));

//oracle数据库建表语句
CREATE TABLE T_ISCB_TMP_MAIN(fid varchar2(32)  not null, ftime timestamp not null, CONSTRAINT PK_ISCB_TMP_MAIN primary key(fid));
CREATE TABLE T_ISCB_TMP_RETURNS(fid varchar2(32) not null, fseq integer not null, fdata blob not null, ftime timestamp not null, fhasmore char(1) not null, CONSTRAINT PK_ISCB_TMP_RETURNS primary key(fid, fseq));

//SqlServer数据库建表语句
CREATE TABLE T_ISCB_TMP_MAIN(fid varchar(32)  not null, ftime datetime not null, CONSTRAINT PK_ISCB_TMP_MAIN primary key(fid));
CREATE TABLE T_ISCB_TMP_RETURNS(fid varchar(32) not null, fseq int not null, fdata image not null, ftime datetime not null, fhasmore char(1) not null, CONSTRAINT PK_ISCB_TMP_RETURNS primary key(fid,fseq));

2.3 测试

测试连接配置，连接配置保存成功后，可以点击“测试”按钮，验证连接是否成功，如果出现“测试

成功！”提示，说明连接配置已经成功。

2.4 加密方式启动

注：以上工作完成后，再以加密的方式启动。

步骤1： DB_PROXY/加密密码.bat（进行修改配置）如图： （需要修改JDK目录和数据库登陆密码，先明文输入数据库登陆密码）。

步骤2： 双击DB_PROXY/加密密码.bat后，获取加密字符串，如图：

步骤3：人工修改文件database.ini（DB_PROXY\webapps\isc\WEB-INF）中用“加密字符串”替换“原明文密码”。

修改前：

修改后：

步骤4： 执行启动TOMCAT.bat启动数据库代理。