Zurück zur englischen Version der DokumentationsetRdbcX, gespeicherte Prozedur (Variante 1)
setRdbcX gespeicherte Prozedur in der Data Virtualization
Letzte Aktualisierung: 26. Nov. 2024
Definiert eine neue Datenquellenverbindung auf einem oder mehreren Endpunktknoten. Diese Variante ist für die Verwendung mit URL-basierten Parametern vorgesehen. Das Schema ist DVSYS.
Eingabeparameter
- Treiber
- Der Typ dieses erforderlichen Parameters ist VARCHAR (128). Gibt die Treiberklasse der Datenquelle an.
- URI
- Der Typ dieses erforderlichen Parameters ist VARCHAR (2000). Gibt den URI der Datenquellenverbindung an.
- Benutzer
- Der Typ dieses optionalen Parameters ist VARCHAR (128). Gibt den Benutzernamen einer Datenquelle an.
- Kennwort
- Der Typ dieses unverschlüsselten optionalen Parameters ist VARCHAR (128). Gibt ein Datenquellenkennwort an.
- trust_store_location
- Der Typ dieses optionalen Parameters ist VARCHAR (128). Gibt einen Platzhalter im URI für die tatsächliche Position des Truststores an, der das Zertifikat enthält.
- SSL_certificate
- Der Typ dieses optionalen Parameters ist VARCHAR (32672). Gibt bei Bedarf ein Zertifikat des Datenquellenservers an.
- driver_ID
- Der Typ dieses optionalen Parameters ist VARCHAR (128). Gibt die Treiber-ID an, die verwendet werden soll, wenn Sie einen Treiberdownload vom API-Server anfordern.
- node_name
- Der Typ dieses erforderlichen Parameters ist VARCHAR (32672). Gibt die Namen der Knoten an, auf denen die Datenquelle definiert ist.
- 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:
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.call DVSYS.setRdbcX('old_dsDriver', 'old_dsUrl', 'old_usr', 'newP@ssw0rd', '', '', '', 'NodeIdForMyDB2', 'EDITCID=MYSQL11941', ?, ?, ?)
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('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', '', ?, ?, ?)"
Wenn Sie eine Datenquelle mit einem neuen Kennwort bearbeiten möchten, können Sie den Parameter additional_optionsmit EDITCID verwenden.
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', ?, ?, ?)"