Eingabeparameter

src_type

Der Typ dieses erforderlichen Parameters ist VARCHAR (20). Gibt den Datenquellentyp an.

host_name

Der Typ dieses erforderlichen Parameters ist VARCHAR (2000). Gibt den Hostnamen der Datenquelle an.

db_port

Der Typ dieses erforderlichen Parameters ist INTEGER. Gibt den Netzport des Datenquellenservice an.

Datenbankname

Der Typ dieses optionalen Parameters ist VARCHAR (128). Gibt den Namen der Datenbank für die Verbindung an.

connection_options

Der Typ dieses optionalen Parameters ist VARCHAR (2000). Gibt eine durch Kommas begrenzte Liste mit zusätzlichen Optionen im folgenden Format an: '<key1>=<value1>, <key2>=<value2>, ...'.

Benutzer

Der Typ dieses erforderlichen Parameters ist VARCHAR (128). Gibt einen Datenbankbenutzernamen an.

Kennwort

Der Typ dieses unverschlüsselten erforderlichen Parameters ist VARCHAR (128). Gibt ein Datenbankbenutzerkennwort an.

use_SSL

Der Typ dieses erforderlichen Parameters ist INTEGER. Gibt an, ob die Datenbankverbindung SSL verwendet. Gültige Werte sind 0 (die Verbindung verwendet kein SSL) und 1 (die Verbindung verwendet SSL).

validate_cert

Der Typ dieses erforderlichen Parameters ist INTEGER. Gibt an, ob der Endpunkt das SSL-Zertifikat des Datenbankservers validiert. Gültige Werte sind 0 (keine Validierung) und 1 (Validierung erforderlich).

cert_host_name

Der Typ dieses optionalen Parameters ist VARCHAR (2000). Gibt den Namen des Hosts an, der dem Zertifikat zugeordnet ist. Die Angabe einer leeren Zeichenfolge oder des Nullwerts verhindert die Validierung des Hostnamens.

SSL_certificate

Der Typ dieses optionalen Parameters ist VARCHAR (32672). Gibt bei Bedarf ein Datenbankserverzertifikat an.

node_name

Der Typ dieses erforderlichen Parameters ist VARCHAR (32672). Gibt die Namen der Knoten an, auf denen die Datenquelle definiert ist.

Führen Sie die folgende Abfrage aus, um gültige Werte für node_namezu suchen.

SELECT * FROM DVSYS.LISTNODES;

additional_options

Der Typ dieses optionalen Parameters ist VARCHAR (32672). Gibt eine durch Kommas begrenzte Liste mit zusätzlichen Parametern im folgenden Format an: '<key1>=<value1>, <key2>=<value2>, ...'. Unterstützte Optionen sind EDITCID, DRIVERID und JWTTOKEN. Wenn Sie EDITCID angeben, werden vorhandene Verbindungsinformationen durch die neuen Informationen ersetzt, die Sie angeben. Beispiel:

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

DRIVERID (die ID des herunterzuladenden Treibers) und JWTTOKEN (das Java-Web-Token) werden zusammen verwendet, wenn diese Parameter festgelegt werden. Der Connector/Endpunkt lädt den Treiber vom Server herunter.

Zugriffsbeschränkungen: Verwenden Sie diese Option, um Zugriffsbeschränkungen zu aktivieren Data Virtualization. Fügen Sie die Einschränkungen in Form einer verschachtelten durch Kommas getrennten Liste von Tupeln hinzu, die den Typ des Zugriffsberechtigungsempfängers (Benutzer, Gruppe oder Rolle) und ihre Namen angeben. Beispiel:

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

Verwenden Sie keine Anführungszeichen, um die Namen einzuschließen. Verwenden Sie beispielsweise ACCESS_RESTRICTION={G ALL USERS} anstelle von ACCESS_RESTRICTION={G "ALL USERS"}.

Ausgabeparameter

connection_ID

Der Typ dieses Parameters ist VARCHAR (20). Stellt die generierte Verbindungs-ID für die Data Virtualization dar.

number_of_defined_connections

Der Typ dieses Parameters ist INTEGER. Stellt die Gesamtzahl der hinzugefügten Verbindungen dar.

Diagnose

Der Typ dieses Parameters ist VARCHAR (32672). Stellt die Diagnoseausgabe dar, wenn ein Fehler auftritt.

Beispiel

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',?,?,?);