Portail de support Workiva

Avec le connecteur JDBC, vous pouvez utiliser les commandes dans une chaîne pour effectuer des opérations en langage de requête structuré (SQL) dans des solutions sur site qui prennent en charge la connectivité aux bases de données Java® (JDBC). 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 de base de données
• Insérer des enregistrements dans une base de données via JDBC

Remarque : Pour se connecter à Amazon® Redshift®, IBM® Db2®, Microsoft® SQL Server®, MySQL®, NetSuite® JDBC, Oracle® Relational Database Management System (RDBMS) ou Autonomous Data Warehouse (ADW), Postgres®, SAP HANA® JDBC, ou Snowflake®, utilisez plutôt son connecteur respectif.

Conditions préalables

Pour sécuriser la connexion JDBC, le connecteur utilise 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é dans la solution à laquelle vous vous connectez.
• Les informations d'authentification de l'utilisateur d'intégration.
• L'URL de la connexion JDBC, telle que jdbc:solution://host:port/database
• A GroundRunner dédié au connecteur, car les CloudRunners ne sont pas pris en charge.
• Le pilote JDBC pour la connexion, y compris son nom de classe et son chemin d'accès sur le système de fichiers du GroundRunner.
• Pour fournir des options Java personnalisées lors de l’utilisation de ce connecteur, définissez la variable d’environnement JDK_JAVA_OPTIONS pour le GroundRunner. Par exemple, si vous utilisez Databricks, vous devez utiliser ce qui suit :
  JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED". Ceci est similaire aux variables de configuration définies dans Install and manage GroundRunners. 
  Important : Vous devez redémarrer l’ordinateur sur lequel le GroundRunner fonctionne après avoir défini cette variable.

Note : Le pilote doit être situé sur le GroundRunner, car les fichiers .jar ne peuvent pas être téléchargés en tant que ressources.

Configurer le connecteur JDBC

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. Depuis Chain Builder, cliquez sur Connections compare_arrows, puis Create en haut à droite.
2. Sous Connector Connection, sélectionnez JDBC et le GroundRunner à utiliser avec la connexion.
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier la connexion.

4. Sous Propriétés, entrez les détails de la connexion :
   

   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:solution://host:port/database.
   Classe d'entraînement JDBC	Saisissez le nom de la classe du fichier .jar du pilote JDBC. Par exemple, pour Sybase®, entrez com.sybase.jdbc.sybdriver.
   Chemin d'accès au pilote JDBC	Entrez le chemin d'installation du pilote JDBC sur le système de fichiers du GroundRunner.

   Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement Advanced Encryption Standard (AES)-256.

5. Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
6. Arrêtez et redémarrez l’ordinateur sur lequel tourne le GroundRunner pour réinitialiser la JVM.
7. 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 JDBC é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, le port et la base de données.
• Vérifiez le nom de la classe du pilote JDBC ou le chemin d'accès saisi pour le connecteur.

Si la connexion n’exécute pas une commande, vérifiez que ses entrées (telles que la syntaxe ou la table SQL) sont valides.