Se connecter aux bases de données Oracle à partir de flux de travail dans Azure Logic Apps

S’applique à : Azure Logic Apps (Consommation + Standard)

Lorsque vos flux de travail doivent utiliser des données Oracle, connectez-vous à votre base de données Oracle à l’aide du connecteur Oracle Database dans Azure Logic Apps. Vous pouvez accéder aux bases de données hébergées localement ou sur une machine virtuelle Azure.

Le connecteur Oracle Database vous aide à résoudre les tâches courantes d’intégration des données, telles que :

Ajoutez des enregistrements client à votre base de données.
Mettez à jour les enregistrements de commande dans votre base de données.
Obtenez, insérez ou supprimez des lignes de table dans le cadre de votre flux de travail.

Versions d’Oracle Database prises en charge

Le tableau suivant répertorie les versions de base de données Oracle prises en charge par chaque connecteur :

Connector	Application logique	Versions d’Oracle DB prises en charge
Géré	-Consommation -Standard	- Oracle 9 et versions ultérieures - Client d’accès aux données Oracle (ODAC) 11.2 et versions ultérieures
Intégré (préversion)	Norme	Oracle Database 11 et versions ultérieures

Référence technique du connecteur

Le connecteur Oracle Database a différentes versions, en fonction du type de flux de travail d’application logique et de l’environnement hôte.

Application logique	ID environnement	Version du connecteur
Consommation	Azure Logic Apps multilocataire	Connecteur managé, qui apparaît dans la galerie de connecteurs sous le filtre partagé . Pour plus d’informations, consultez la référence du connecteur géré Oracle Database.
Standard	Azure Logic Apps à locataire unique, App Service Environment v3 (plans Windows uniquement) et hybride	Connecteur managé, qui apparaît dans la galerie de connecteurs sous le filtre partagé et connecteur intégré (préversion publique), qui apparaît dans la galerie de connecteurs sous le filtre intégré . La version intégrée s'exécute en cours avec le runtime Azure Logic Apps et ne nécessite pas la passerelle de données locale, car le runtime peut atteindre votre point de terminaison Oracle sur le réseau. Pour plus d’informations, consultez : - Référence du connecteur géré Oracle Database - Informations de référence sur le connecteur intégré

Opérations de connecteur intégrées (aperçu)

Le connecteur intégré prend actuellement en charge les actions suivantes :

Nom	Paramètres	Description	Retours
Exécuter une requête (`executeQuery`)	- Requête (`query`) : obligatoire pour le type `string`. Requête SQL à exécuter. - Paramètres de requête (`queryParameters`) : facultatif avec `object` type. Paramètres de requête à inclure.	Exécute une requête SQL.	Résultat de la requête SQL en tant que `array`.
Exécuter une procédure stockée (`executeStoredProcedure`)	- Nom de la procédure stockée (`storedProcedure`) : obligatoire avec le type `string`. Nom de la procédure stockée à exécuter. - Paramètres de procédure stockée (`storedProcedureParameters`) : facultatif avec `object` type. Paramètres de procédure stockée à inclure.	Exécute une procédure stockée et retourne les jeux de résultats et les paramètres de sortie.	- Jeux de résultats (`resultSets`) avec un `string` type. La liste des ensembles de résultats retournés par la procédure stockée. - Paramètres de sortie (`outputParmaters`) de type `string`. Les valeurs des paramètres de sortie retournées par la procédure stockée.
Obtenir des lignes (`getRows`)	- Nom de la table (`tableName`) : requis avec le `string` type. Nom de la table source. - Condition WHERE (`columnValuesForWhereCondition`) : facultatif avec un type `object`. Paire clé-valeur de colonnes qui identifient les lignes à obtenir. - Offset pour Get Rows (`skipCount`) : facultatif avec le type de `string`. Nombre d’entrées à ignorer. La valeur par défaut est 0. - Nombre maximal de lignes (`maxcount`) : facultatif avec `string` type. Nombre maximal de lignes à récupérer. La valeur par défaut est 0. - Colonne de classement (`orderBy`) : facultatif avec `string` type. Nom de colonne à utiliser pour classer le résultat de la requête. - Sélectionner des colonnes (`filterBy`) : facultatif pour le type `string`. Valeur de colonne à obtenir à partir de la table ou de la vue.	Obtient une ou plusieurs lignes en fonction de la condition spécifiée.	Lignes extraites sous forme de `array`.
Obtenir des tables (`getTables`)	Retourne uniquement les tables appartenant à l’utilisateur actuel (`ownedTables`) : facultatif avec `string` type. Retourne uniquement les tables où le propriétaire est l’utilisateur fourni.	Obtient une liste de tables de base de données.	La liste des tables sous forme de `array`.
Insérer une ligne (`insertRow`)	- Nom de la table (`tableName`) : requis avec le `string` type. Nom de la table. - Définir des colonnes (`setColumns`) : facultatif avec `object` type. Valeurs des champs de ligne.	Insère une ligne.	La ligne insérée de type `object`.

Prérequis

Un compte et un abonnement Azure. Obtenez un compte Azure gratuit.
Ressource et flux de travail de l’application logique à partir duquel se connecter à votre base de données Oracle.

Ce connecteur fournit seulement des actions, et non pas des déclencheurs. Vous pouvez utiliser n’importe quel déclencheur pour démarrer votre workflow. Pour créer la ressource et le flux de travail de l’application logique, puis ajouter un déclencheur, consultez :

Prérequis du connecteur géré (Consommation et Standard)

Téléchargez et installez la passerelle de données locale.

Cette passerelle sert de pont et assure la sécurité du transfert de données entre les données locales et votre application ou client. Vous pouvez utiliser la même installation de passerelle avec plusieurs services et sources de données, ce qui signifie que vous devez peut-être installer la passerelle une seule fois.
Installez votre client Oracle sur l’ordinateur où vous avez installé la passerelle de données locale. Sinon, une erreur se produit quand vous essayez de créer ou d’utiliser la connexion.
Créez une ressource de passerelle Azure pour votre installation de passerelle.

Prérequis du connecteur intégré (Standard, préversion)

Assurez-vous que votre flux de travail d’application logique standard peut atteindre votre point de terminaison Oracle, y compris n’importe quel hôte, port, résolution DNS et règles de pare-feu.

Lorsque vous créez la connexion de base de données Oracle, vous avez besoin des valeurs suivantes :

Adresse IP du serveur de base de données Oracle
Nom d’utilisateur
Mot de passe

Pour l’adresse IP du serveur, spécifiez cette valeur dans les formats suivants :

Format	Syntaxe	Example
Easy Connect (non SSL)	< host> :<port>/<database-service-name>	`localhost:1522/XE`
Descripteur TNS (Transparent Network Substrate) (SSL) : descripteur de source de données Oracle complet	(description=(retry_count=<retries>)(retry_delay=<durée-d'attente>)(address=(protocol=tcps)(port=<port-numéro>)(host=<hôte>))(connect_data=(service_name=<nom-du-service>))(security=(ssl_server_dn_match=oui)))	(description=(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=localhost))(connect_data=(service_name=XE))(security=(ssl_server_dn_match=yes)))

Pour l’action Obtenir la ligne utilisée dans cet exemple, vous devez connaître l’identificateur de la table à consulter.

Si vous ne connaissez pas ces informations, contactez votre administrateur Oracle Database ou obtenez la sortie de l’instruction suivante : select * from <table-name>.

Problèmes connus et limitations

Les versions actuelles du connecteur ne prennent pas en charge les déclencheurs. Utilisez n’importe quel déclencheur qui correspond à votre scénario pour démarrer votre flux de travail, puis ajoutez des actions Oracle.

Connector	Limitations
Géré	- Tables avec des clés composites - Tables avec des types d’objets imbriqués - Fonctions de base de données avec des valeurs noncalaires
Intégré	- Aucune action de mise à jour ou de suppression dédiée. Pour les scénarios de mise à jour et de suppression, utilisez les actions Exécuter une requête ou Exécuter une procédure stockée . - Certains problèmes de connexion peuvent apparaître uniquement au moment de l’exécution du flux de travail, plutôt qu’au moment de la création de la connexion.

Ajouter une action

Les étapes à suivre pour ajouter et utiliser une action Oracle diffèrent selon que vous utilisez le connecteur intégré ou le connecteur managé.

Ajouter une action de connecteur intégrée (Standard, préversion)

Dans le portail Azure, ouvrez votre ressource d’application logique Standard.
Dans le concepteur, ouvrez votre flux de travail.
Suivez les étapes génériques pour ajouter l’action Oracle Database que vous souhaitez à votre flux de travail.

Cet exemple continue avec l’action Obtenir des lignes .
Dans le volet informations de connexion, entrez les informations requises, telles que le nom de connexion souhaité, l’adresse IP du serveur de base de données Oracle, le nom d’utilisateur et le mot de passe, par exemple :
Quand vous avez terminé, sélectionnez Créer nouveau.
Dans le volet d’informations d’action, entrez les valeurs de paramètre requises pour votre action sélectionnée.

Par exemple, si vous sélectionnez l’action Obtenir des lignes , entrez le nom de la table :
Ajoutez toutes les autres actions nécessaires pour terminer votre flux de travail.
Enregistrez le flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Ajouter une action de connecteur géré (Consommation et Standard)

Dans le portail Azure, ouvrez votre ressource Consommation ou application logique Standard.
Dans le concepteur, ouvrez votre flux de travail.
Suivez les étapes génériques pour ajouter l’action Oracle Database que vous souhaitez à votre flux de travail.

Cet exemple continue avec l'action Récupérer une ligne.
Dans le volet Informations de connexion, entrez les informations de connexion requises.
Pour la propriété Gateway, sélectionnez l’abonnement Azure et la ressource de passerelle Azure à utiliser.
Une fois la connexion terminée, dans la liste des noms de table, sélectionnez une table.
Pour la propriété Row Id, entrez l’ID de ligne que vous voulez dans votre table.

Dans l’exemple suivant, les données de travail sont renvoyées à partir d’une base de données de ressources humaines :
Ajoutez toutes les autres actions nécessaires pour terminer votre flux de travail.
Enregistrez le flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Résoudre les problèmes de connexion à la base de données Oracle

Erreur : La passerelle est injoignable

Cause : la passerelle de données locale ne peut pas se connecter au cloud.

Atténuation: vérifiez que votre passerelle s’exécute sur l’ordinateur sur site où vous l’avez installée et qu’elle dispose d'une connexion Internet. Évitez d'installer la passerelle sur un ordinateur qui pourrait être éteint ou mis en veille. Vous pouvez également essayer de redémarrer le service de passerelle de données locale (PBIEgwService).

Erreur : le fournisseur utilisé est déprécié : « System.Data.OracleClient nécessite le logiciel client Oracle version 8.1.7 ou supérieure ». Pour installer le fournisseur officiel, consultez https://go.microsoft.com/fwlink/p/?LinkID=272376.

Cause : le SDK du client Oracle n’est pas installé sur l’ordinateur qui exécute la passerelle de données locale.

Résolution : téléchargez et installez le kit de développement logiciel du client Oracle sur le même ordinateur que la passerelle de données locale.

Erreur : La table « [Tablename] » ne définit aucune colonne clé

Cause : la table n’a pas de clé primaire.

Résolution : le connecteur Oracle Database nécessite une table avec une colonne de clé primaire.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-05-01