Portail de support Workiva

Avec le connecteur Postgres, vous pouvez utiliser les commandes dans une chaîne pour effectuer des opérations en langage de requête structuré (SQL) dans les systèmes de base de données PostgreSQL, tels qu'Amazon® Aurora®. Par exemple, avec ce connecteur, vous pouvez :

• Exécuter des commandes SQL, y compris une instruction CREATE ou UPDATE ou une requête SELECT.
• Récupérer les détails d'une table dans une base de données PostgreSQL
• Insérer des enregistrements dans une base de données PostgreSQL

Conditions préalables

Pour permettre la connexion à la base de données PostgreSQL, le connecteur utilise la connectivité de base de données Java (JDBC), sécurisée par une authentification de base par nom d'utilisateur et mot de passe. Pour configurer le connecteur, vous aurez besoin de :

• Un utilisateur d'intégration désigné créé dans la base de données pour le connecteur
• Nom d'utilisateur et mot de passe de l'utilisateur d'intégration
• L'URL de la connexion JDBC, par exemple jdbc:postgresql://localhost:5432/sample
• Pour se connecter à une base de données sur site, un GroundRunner pour la connexion

Note : Pour se connecter à une base de données PostgreSQL en nuage, utilisez le CloudRunner par défaut.

Configurer le connecteur Postgres

Note : pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un admin de sécurité de l’org. doit d’abord l’activer à partir de Configuration.

1. À partir du Générateur de chaînes, cliquez sur Connexions  compare_arrows, puis sur Créer en haut à droite.
2. Sous Connector Connection, sélectionnez Postgres et le programme d'exécution à utiliser avec la connexion.
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier la connexion.
4. Sous Properties, entrez les détails du connecteur :
   
   

   Propriété	Détails
   Nom d’utilisateur	Saisissez le nom d'utilisateur de l'utilisateur d'intégration du connecteur.
   Mot de passe	Saisissez le mot de passe pour la propriété Username.
   URL de connexion	Saisissez l'URL de la connexion JDBC, par exemple jdbc:postgresql://<server>:<port>/<database>. Pour inclure des propriétés facultatives pour la connexion, ajoutez-les à une chaîne de requête, comme jdbc:postgresql://localhost:5432/sample ?<options>. Par exemple, pour établir une connexion SSL (Secure Sockets Layer), ajoutez ?ssl=true. Note : Par défaut, le port est 5432; cependant, cela peut être différent dans votre environnement.

   Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement Advanced Encryption Standard (AES)-256. Pour des raisons de sécurité, évitez d'inclure les informations d'identification de l'utilisateur en tant que propriétés facultatives dans la propriété Connection URL.

5. Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
6. Pour tester la connexion, créez et exécutez une chaîne avec la commande Get Table Definition du connecteur et vérifiez qu'elle renvoie un résultat valide.

Dépannage

Si la connexion à la base de données PostreSQL échoue :

• • Vérifiez les informations d'authentification de l'utilisateur d'intégration.
  • Vérifiez l'URL de la connexion JDBC, y compris le serveur et le port.
  • Si vous vous connectez à une base de données sur site, vérifiez le GroundRunner sélectionné pour le connecteur.

  Si la connexion ne parvient pas à exécuter une commande, vérifiez que ses entrées, telles que la syntaxe SQL ou la table, sont valides.