Workiva-ondersteuningscentrum

Met de Postgres-connector kunt u commando's in een keten gebruiken om gestructureerde querytaal (SQL) bewerkingen uit te voeren in PostgreSQL databasesystemen, zoals Amazon® Aurora®. Met deze connector kunt u bijvoorbeeld:

• SQL-opdrachten uitvoeren, inclusief een CREATE of UPDATE verklaring of SELECT query
• Details over een tabel in een PostgreSQL database ophalen
• Records invoegen in een PostgreSQL database

Vereisten

Om de verbinding met de PostgreSQL database mogelijk te maken, gebruikt de connector Java database connectivity (JDBC), beveiligd met een basis gebruikersnaam en wachtwoord. Om de connector in te stellen, hebt u het volgende nodig:

• Een aangewezen integratiegebruiker die in de database is aangemaakt voor de connector
• De gebruikersnaam en het wachtwoord van de integratiegebruiker
• De URL van de JDBC-verbinding, zoals jdbc:postgresql://localhost:5432/sample
• Om verbinding te maken met een on-premise database, een GroundRunner voor de verbinding

Opmerking: Gebruik de standaard CloudRunner om verbinding te maken met een PostgreSQL-database in de cloud.

De Postgres-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection, Postgres en de runner die u met de verbinding wilt gebruiken.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.
4. Voer onder Eigenschappen de gegevens van de connector in:
   
   

   Eigendom	Details
   Gebruikersnaam	Voer de gebruikersnaam van de integratiegebruiker van de connector in.
   Wachtwoord	Voer het wachtwoord in voor de eigenschap Username.
   URL verbinding	Voer de URL voor de JDBC-verbinding in, zoals jdbc:postgresql://<server>:<poort>/<database>. Om optionele eigenschappen voor de verbinding op te nemen, voegt u ze toe als een querystring, zoals jdbc:postgresql://localhost:5432/sample?<options>. Om bijvoorbeeld een SSL-verbinding (Secure Sockets Layer) tot stand te brengen, voegt u ?ssl=true toe. Opmerking: Standaard is de poort 5432; dit kan echter voor uw omgeving anders zijn.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering. Vermijd om veiligheidsredenen het opnemen van gebruikersreferenties als optionele eigenschappen binnen de eigenschap Connection URL.

5. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
6. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de opdracht Get Table Definition van de connector en controleert of deze een geldige uitvoer oplevert.

Probleemoplossing

Als de verbinding met de PostreSQL database mislukt:

• • Controleer de verificatiegegevens van de integratiegebruiker.
  • Controleer de URL voor de JDBC-verbinding, inclusief de server en poort.
  • Als u verbinding maakt met een on-premise database, controleer dan de GroundRunner die voor de connector is geselecteerd.

  Als de verbinding een opdracht niet kan uitvoeren, controleer dan of de invoer, zoals de SQL-syntaxis of tabel, geldig is.