Workiva Support Center

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 CREATE oder UPDATE Anweisung oder SELECT Abfrage
• 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.lck
• cwallet.sso
• ewallet.p12
• keystore.jks
• sqlnet.ora
• tnsnames.ora
• truststore.jks
• ojdbc.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.

1. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Wählen Sie unter Connector Verbindung, Oracle RDBMS | ADW und den Läufer, der mit dem Connector verwendet werden soll.
   
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
4. Um eine Verbindung zu Oracle ADW herzustellen, laden Sie unter Resources die Wallet-Dateien der Datenbank hoch.
5. 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_ADMIN Pfad 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.

6. Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
7. 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_ADMIN Pfad 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.