Mit dem Oracle® RDBMS | ADW-Konnektor können Sie Befehle in einer Kette verwenden, um SQL-Operationen (Structured Query Language) im Oracle Relational Database Management System (RDBMS) oder Autonomous Data Warehouse® (ADW) durchzuführen. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:
- Ausführen von SQL-Befehlen, einschließlich einer
CREATEoderUPDATEAnweisung oderSELECTAbfrage - Abrufen von Details über eine Tabelle in Oracle RDBMS oder ADW
- Einfügen von Datensätzen in Oracle RDBMS oder ADW
Hinweis: Dieser Konnektor wird von Workiva hergestellt und verbindet sich mit einem System eines Drittanbieters. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.
Anforderungen
Um die Verbindung zur Oracle-Datenbank zu ermöglichen, verwendet der Konnektor die Java Database Connectivity (JDBC), die durch eine einfache Authentifizierung mit Benutzernamen und Passwort gesichert ist. Zur Einrichtung des Konnektors benötigen Sie Folgendes:
- Ein bestimmter Integrationsbenutzer, der in Oracle RDBMS oder ADW für den Konnektor erstellt wurde
- Der Benutzername und das Passwort des Integrationsbenutzers
- Die URL der JDBC-Verbindung, z. B.
jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./ - Um eine Verbindung zu Oracle ADW herzustellen, müssen die Client-Anmeldeinformationen oder Wallet-Dateien der Datenbank
- Um eine Verbindung zu einer lokalen Datenbank herzustellen, ein GroundRunner für die Verbindung
Unterstützte Versionen
Der Oracle® RDBMS | ADW-Konnektor ist mit den folgenden Datenbankversionen kompatibel:
- 21.x
- 19.x
- 18.3
- 12.2
- 12.1
- 11.2.0.4
ADW-Wallet-Dateien
Um eine Verbindung zu Oracle ADW zu ermöglichen, laden Sie zunächst die Client-Anmeldeinformationen oder Wallet-Dateien der Datenbank herunter. Wenn Sie den Connector einrichten, laden Sie diese Wallet-Dateien unter Resources hoch:
cwallet.sso.lck\n* ewallet.p12.lckcwallet.ssoewallet.p12keystore.jkssqlnet.oratnsnames.oratruststore.jksojdbc.properties
Um den Speicherort dieser Ressourcen in der Eigenschaft Connection URL des Konnektors anzugeben, geben Sie den Pfad TNS_ADMIN auf der Grundlage des GroundRunner-Betriebssystems ein:
- Für UNIX:
TNS_ADMIN=./ - Für Microsoft® Windows®,
TNS_ADMIN=.
Hinweis: Wenn der Connector einen CloudRunner verwendet, verwenden Sie den Pfad TNS_ADMIN=./.
Einrichten des Konnektors Oracle RDBMS | ADW
Hinweis: Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn zunächst aktivieren unter Konfiguration.
- Klicken Sie unter Chain-Generator auf Verbindungen und dann auf Erstellen oben rechts.
- Wählen Sie unter Connector Verbindung, Oracle RDBMS | ADW und den Läufer, der mit dem Connector verwendet werden soll.
- Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
- Um eine Verbindung zu Oracle ADW herzustellen, laden Sie unter Resources die Wallet-Dateien der Datenbank hoch.
- Geben Sie unter Eigenschaften die Details des Connectors ein:
Eigenschaft Details Benutzername Geben Sie den Benutzernamen des Integrationsbenutzers des Connectors ein. Kennwort Geben Sie das Passwort für die Eigenschaft Benutzername ein. Verbindungs-URL Geben Sie die URL für die JDBC-Verbindung ein, z. B. jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./.- Für Oracle RDBMS, fügen Sie alle optionalen Eigenschaften für die Verbindung.
- Für Oracle ADW fügen Sie den
TNS_ADMINPfad für die Wallet-Dateien der Datenbank an, basierend auf dem ausgewählten Runner und seinem Betriebssystem.
Hinweis: Standardmäßig ist der Port für Oracle RDBMS
1521; dies kann jedoch in Ihrer Umgebung anders sein.Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert. Vermeiden Sie es aus Sicherheitsgründen, Benutzeranmeldeinformationen als optionale Eigenschaften in die Eigenschaft Connection URL aufzunehmen.
- Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
- Um die Verbindung zu testen, erstellen Sie eine Kette und führen Sie diese mit dem Befehl Tabellendefinition beziehen des Konnektors aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.
Fehlersuche
Wenn die Verbindung zu Oracle RDBMS oder ADW fehlschlägt:
- Überprüfen Sie die Authentifizierungsdaten des Integrationsbenutzers.
- Überprüfen Sie die URL für die JDBC-Verbindung.
- Wenn Sie eine Verbindung zu einer lokalen Datenbank herstellen, überprüfen Sie den GroundRunner, der für den Connector ausgewählt wurde.
- Wenn Sie eine Verbindung zu Oracle ADW herstellen, vergewissern Sie sich, dass die Wallet-Dateien der Datenbank unter Resources hochgeladen wurden, und überprüfen Sie deren
TNS_ADMINPfad in der Eigenschaft Connection URL. Laden Sie ggf. die Wallet-Dateien von Oracle ADW herunter und laden Sie sie unter Resources erneut hoch.
Wenn die Verbindung einen Befehl nicht ausführen kann, überprüfen Sie, ob die Eingaben - wie die SQL-Syntax oder die Tabelle - gültig sind.