Portail de support Workiva

Avec le connecteur Oracle® RDBMS | ADW, vous pouvez utiliser les commandes dans une chaîne pour effectuer des opérations en langage de requête structuré (SQL) dans Oracle Relational Database Management System (RDBMS) ou Autonomous Data Warehouse® (ADW). 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 Oracle RDBMS ou ADW
• Insérer des enregistrements dans Oracle RDBMS ou ADW

Note: Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.

Exigences

Pour permettre la connexion à la base de données Oracle, 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 Oracle RDBMS ou ADW 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:oracle:thin:@db201905221856_high?TNS_ADMIN=./
• Pour se connecter à Oracle ADW, les informations d'identification du client de la base de données ou les fichiers wallet
• Pour se connecter à une base de données sur site, un GroundRunner pour la connexion

Versions prises en charge

Le connecteur Oracle® RDBMS | ADW est compatible avec les versions suivantes de la base de données :

• 21.x
• 19.x
• 18.3
• 12.2
• 12.1
• 11.2.0.4

Fichiers du portefeuille ADW

Pour permettre une connexion à Oracle ADW, il faut d'abord télécharger les informations d'identification du client de la base de données ou les fichiers wallet. Lorsque vous configurez le connecteur, vous téléchargez ces fichiers de portefeuille sous Resources:

• cwallet.sso.lck\n* ewallet.p12.lck
• cwallet.sso
• ewallet.p12
• keystore.jks
• sqlnet.ora
• tnsnames.ora
• truststore.jks
• ojdbc.properties

Pour indiquer l'emplacement de ces ressources dans la propriété Connection URL du connecteur, entrez le chemin TNS_ADMIN en fonction du système d'exploitation du GroundRunner :

• Pour UNIX, TNS_ADMIN=./
• Pour Microsoft® Windows®, TNS_ADMIN=.

Note : Si le connecteur utilise un CloudRunner, utilisez le chemin TNS_ADMIN=./.

Configurer le connecteur Oracle RDBMS | ADW

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 Oracle RDBMS | ADW et le programme d'exécution à utiliser avec le connecteur.
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier la connexion.
4. Pour se connecter à Oracle ADW, sous Resources, téléchargez les fichiers wallet de la base de données.
5. 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:oracle:thin:@db201905221856_high?TNS_ADMIN=./. Pour le SGBDR Oracle, ajoute toutes les propriétés optionnelles pour la connexion. Pour Oracle ADW, ajoutez le chemin TNS_ADMIN pour les fichiers de portefeuille de la base de données, en fonction du programme d'exécution sélectionné et de son système d'exploitation. Note : Par défaut, le port pour Oracle RDBMS est 1521; 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.

6. Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
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 au SGBDR Oracle ou à ADW échoue :

• Vérifiez les informations d'authentification de l'utilisateur d'intégration.
• Vérifiez l'URL de la connexion JDBC.
• Si vous vous connectez à une base de données sur site, vérifiez le GroundRunner sélectionné pour le connecteur.
• Si vous vous connectez à Oracle ADW, vérifiez que les fichiers wallet de la base de données sont téléchargés sous Resources, et vérifiez leur chemin d'accès TNS_ADMIN dans la propriété Connection URL. Si nécessaire, téléchargez les fichiers du portefeuille à partir d'Oracle ADW et téléchargez-les à nouveau sous Resources.

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.