输入参数

驱动程序

此必需参数的类型为 VARCHAR (128)。 指定数据源驱动程序类。

URI

此必需参数的类型为 VARCHAR (2000)。 指定数据源连接 URI。

用户

此可选参数的类型为 VARCHAR (128)。 指定数据源用户名。

密码

此未加密的可选参数的类型为 VARCHAR (128)。 指定数据源密码。

trust_store_location

此可选参数的类型为 VARCHAR (128)。 在 URI 中指定包含证书的信任库的实际位置的占位符。

SSL_证书

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

驱动器标识

此可选参数的类型为 VARCHAR (128)。 指定从 API 服务器请求驱动程序下载时要使用的驱动程序标识。

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('com.ibm.jdbc.oracle.OracleDriver', 'jdbc:ibm:oracle://90.30.146.185:1521;serviceName=pdborcl.test.ibm.com', '<username>', '<password>', null, null, '', 'qpendpoint_1:6415', '', ?, ?, ?)"

call DVSYS.setRdbcX('com.ibm.jdbc.oracle.OracleDriver', 'jdbc:ibm:oracle://90.30.146.185:1521;serviceName=pdborcl.test.ibm.com', '<username>', '<new_password>', null, null, '', 'qpendpoint_1:6415', 'EDITCID=ORAC003', ?, ?, ?)"