入力パラメーター

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 証明書に関連付けられているホストの名前を指定します。 空ストリングまたは NULL 値を指定すると、ホスト名の検証は行われません。

SSL_certificate

このオプション・パラメーターのタイプは 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 (ダウンロードするドライバーの ID) と 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',?,?,?);