输入参数

src_type

此必需参数的类型为 VARCHAR (20)。 指定数据源类型。

host_name

此必需参数的类型为 VARCHAR (2000)。 指定数据源主机名。

DB_PORT

此必需参数的类型为 INTEGER。 指定数据源服务的网络端口。

database_name

此可选参数的类型为 VARCHAR (128)。 指定连接的数据库的名称。

connection_options

此可选参数的类型为 VARCHAR (2000)。 以以下格式指定额外选项的逗号分隔列表: '<key1>=<value1>, <key2>=<value2>, ...'。

用户

此必需参数的类型为 VARCHAR (128)。 指定数据库用户名。

密码

此未加密必需参数的类型为 VARCHAR (128)。 指定数据库用户密码。

use_ssl

此必需参数的类型为 INTEGER。 指定数据库连接是否使用 SSL。 有效值为 0 (连接不使用 SSL) 和 1 (连接使用 SSL)。

validate_cert

此必需参数的类型为 INTEGER。 指定端点是否验证数据库服务器 SSL 证书。 有效值为 0 (无验证) 和 1 (需要验证)。

cert_host_name

此可选参数的类型为 VARCHAR (2000)。 指定与 SSL 证书关联的主机的名称。 指定空字符串或空值会阻止主机名验证。

SSL_证书

此可选参数的类型为 VARCHAR (32672)。 指定数据库服务器证书 (如果需要)。

node_name

此必需参数的类型为 VARCHAR (32672)。 指定定义了数据源的节点的名称。

运行以下查询以查找 node_name的有效值。

SELECT * FROM DVSYS.LISTNODES;

additional_options

此可选参数的类型为 VARCHAR (32672)。 指定以下格式的额外参数的逗号分隔列表: '<key1>=<value1>, <key2>=<value2>, ...'。 支持的选项包括 EDITCID， DRIVERID和 JWTTOKEN。 如果指定 EDITCID，那么现有连接信息将替换为您提供的新信息。 例如：

call DVSYS.setRdbcX('old_dsDriver', 'old_dsUrl', 'old_usr', 'newP@ssw0rd', '', '', '', 'NodeIdForMyDB2', 'EDITCID=MYSQL11941', ?, ?, ?)

DRIVERID (要下载的驱动程序的标识) 和 JWTTOKEN (Java Web 令牌) 在设置这些参数时一起使用。 连接器/端点从服务器下载驱动程序。

访问限制：使用此选项启用访问限制Data Virtualization。 以嵌套的以逗号分隔的元组列表形式添加限制，指定访问被授予者 (用户，组或角色) 的类型及其名称。 例如：

ACCESS_RESTRICTION={U username, G groupname, R rolename}

请勿使用引号将名称换行。 例如，使用 ACCESS_RESTRICTION={G ALL USERS} 而不是 ACCESS_RESTRICTION={G "ALL USERS"}。

输出参数

connection_id

此参数的类型为 VARCHAR (20)。 代表为Data Virtualization生成的连接 ID。

number_of_defined_connections

此参数的类型为 INTEGER。 表示添加的连接总数。

诊断

此参数的类型为 VARCHAR (32672)。 表示发生故障时的诊断输出。

示例

call DVSYS.setRdbcX('DB2','9.30.167.128','50000','TPCDS','','<user>','<password>','0','0','','','qpendpoint_1:6415','',?,?,?);

call DVSYS.setRdbcX('DB2','9.30.167.128','50000','TPCDS','','<user>','<password>','0','0','','','qpendpoint_1:6415','EDITCID=DB2002',?,?,?);