Workiva Support Center

Mit dem JDBC-Connector können Sie Befehle in einer Kette verwenden, um SQL-Operationen (Structured Query Language) in lokalen Lösungen durchzuführen, die Java® Database Connectivity (JDBC) unterstützen. 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 Datenbanktabelle
• Einfügen von Datensätzen in eine Datenbank über JDBC

Anmerkung: Zur Verbindung mit Amazon® Redshift®, IBM® Db2®, Microsoft® SQL Server®, MySQL®, NetSuite® JDBC, Oracle® Relational Database Management System (RDBMS) oder Autonomous Data Warehouse (ADW), Postgres®, SAP HANA® JDBC, oder Snowflake®, verwenden Sie stattdessen den jeweiligen Connector.

Voraussetzungen

Um die JDBC-Verbindung zu sichern, verwendet der Konnektor eine einfache Authentifizierung mit Benutzernamen und Passwort. Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• Ein bestimmter Integrationsbenutzer, der in der Lösung, mit der Sie sich verbinden, eingerichtet ist.
• Die Authentifizierungsdaten des Integrationsbenutzers.
• Die URL der JDBC-Verbindung, z. B. jdbc:solution://host:port/database
• Ein GroundRunner speziell für den Connector, da CloudRunner nicht unterstützt werden.
• Der JDBC-Treiber für die Verbindung, einschließlich des Klassennamens und des Pfades im Dateisystem des GroundRunners.
• Um benutzerdefinierte Java-Optionen bei der Verwendung dieses Connectors bereitzustellen, setzen Sie die Umgebungsvariable JDK_JAVA_OPTIONS für den GroundRunner. Wenn Sie zum Beispiel Databricks verwenden, würden Sie folgendes verwenden:
  JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED". Dies entspricht den Konfigurationsvariablen, die unter GroundRunner installieren und verwalten festgelegt wurden. 
  Wichtig: Sie müssen den Computer, auf dem der GroundRunner betrieben wird, neu starten, nachdem Sie diese Variable gesetzt haben.

Hinweis: Der Treiber muss sich auf dem GroundRunner befinden, da .jar Dateien nicht als Ressourcen hochgeladen werden können.

JDBC-Konnektor einrichten

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. Von Chain Builder, klicken Sie auf Verbindungen compare_arrows, und dann Erstellen oben rechts.
2. Wählen Sie unter Connector Connection, JDBC und den GroundRunner, der mit der Verbindung verwendet werden soll.
   
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.

4. Geben Sie unter Eigenschaften die Details der Verbindung ein:
   

   Eigenschaft	Details
   Benutzername	Geben Sie den Benutzernamen für den Integrationsbenutzer 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:solution://host:port/database.
   JDBC-Laufwerksklasse	Geben Sie den Klassennamen für die .jar-Datei des JDBC-Treibers ein. Für Sybase® geben Sie zum Beispiel com.sybase.jdbc.sybdriver ein.
   Pfad zum JDBC-Treiber	Geben Sie den Pfad zur Installation des JDBC-Treibers im Dateisystem des GroundRunners an.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.

5. Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
6. Fahren Sie den Computer, auf dem der GroundRunner läuft, herunter und starten Sie ihn neu, um die JVM neu zu initialisieren.
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 JDBC-Verbindung fehlschlägt:

• Überprüfen Sie die Authentifizierungsdaten des Integrationsbenutzers.
• Überprüfen Sie die URL für die JDBC-Verbindung, einschließlich Server, Port und Datenbank.
• Überprüfen Sie den Namen der JDBC-Treiberklasse oder den für den Connector eingegebenen Pfad.

Wenn die Verbindung einen Befehl nicht ausführen kann, überprüfen Sie, ob die Eingaben (z.B. die SQL-Syntax oder die Tabelle) gültig sind.