Workiva Support Center

Mit dem Postgres-Konnektor können Sie Befehle in einer Kette verwenden, um SQL-Operationen (Structured Query Language) in PostgreSQL-Datenbanksystemen, wie Amazon® Aurora®, 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 einer PostgreSQL-Datenbank
• Einfügen von Datensätzen in eine PostgreSQL-Datenbank

Voraussetzungen

Um die Verbindung zur PostgreSQL-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 der Datenbank für den Konnektor erstellt wurde
• Der Benutzername und das Passwort des Integrationsbenutzers
• Die URL der JDBC-Verbindung, z. B. jdbc:postgresql://localhost:5432/sample
• Um eine Verbindung zu einer lokalen Datenbank herzustellen, ein GroundRunner für die Verbindung

Hinweis: Um eine Verbindung zu einer Cloud-PostgreSQL-Datenbank herzustellen, verwenden Sie den Standard-CloudRunner.

Den Postgres-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. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Wählen Sie unter Connector Verbindung, Postgres und den Läufer, 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 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:postgresql://<server>:<port>/<database>. Um optionale Eigenschaften für die Verbindung hinzuzufügen, fügen Sie sie als Abfragezeichenfolge an, z. B. jdbc:postgresql://localhost:5432/sample?<options>. Um beispielsweise eine SSL-Verbindung (Secure Sockets Layer) herzustellen, fügen Sie ?ssl=true an. Hinweis: Standardmäßig ist 5432 der Port; 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.

5. Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
6. 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 zur PostreSQL-Datenbank fehlschlägt:

• • Überprüfen Sie die Authentifizierungsdaten des Integrationsbenutzers.
  • Überprüfen Sie die URL für die JDBC-Verbindung, einschließlich des Servers und des Ports.
  • Wenn Sie eine Verbindung zu einer lokalen Datenbank herstellen, überprüfen Sie den GroundRunner, der für den Connector ausgewählt wurde.

  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.