Prise en main du connecteur de base de données OracleGet started with the Oracle Database connector

À l’aide du connecteur de base de données Oracle, vous créez des workflows d’organisation qui utilisent des données de votre base de données existante.Using the Oracle Database connector, you create organizational workflows that use data in your existing database. Ce connecteur peut se connecter à une base de données Oracle locale ou à une machine virtuelle sur laquelle la base de données Oracle est installée.This connector can connect to an on-premises Oracle Database, or an Azure virtual machine with Oracle Database installed. Avec ce connecteur, vous pouvez :With this connector, you can:

  • Créez votre flux de travail en ajoutant un nouveau client à une base de données clients ou en mettant à jour une commande dans une base de données de commandes.Build your workflow by adding a new customer to a customers database, or updating an order in an orders database.
  • Utilisez des actions pour obtenir une ligne de données, insérer une nouvelle ligne ou en supprimer.Use actions to get a row of data, insert a new row, and even delete. Par exemple, quand un enregistrement est créé dans Dynamics CRM Online (déclencheur), insérez une ligne dans une base de données Oracle (action).For example, when a record is created in Dynamics CRM Online (a trigger), then insert a row in an Oracle Database (an action).

Cet article décrit comment utiliser le connecteur de base de données Oracle dans une application logique.This article shows you how to use the Oracle Database connector in a logic app.

PrérequisPrerequisites

  • Versions d’Oracle prises en charge :Supported Oracle versions:

    • Oracle 9 et versions ultérieuresOracle 9 and later
    • Logiciel client Oracle 8.1.7 et versions ultérieuresOracle client software 8.1.7 and later
  • Installez la passerelle de données locale.Install the on-premises data gateway. Connexion à des données locales à partir d’applications logiques répertorie les étapes à suivre.Connect to on-premises data from logic apps lists the steps. La passerelle vous permet de vous connecter à une base de données Oracle locale ou à une machine virtuelle Azure sur laquelle la base de données Oracle est installée.The gateway is required to connect to an on-premises Oracle Database, or an Azure VM with Oracle DB installed.

    Notes

    La passerelle de données locale agit comme un pont et fournit un transfert de données sécurisé entre les données locales (qui ne sont pas sur le cloud) et vos applications logiques.The on-premises data gateway acts as a bridge, and provides a secure data transfer between on-premises data (data that is not in the cloud) and your logic apps. La même passerelle peut être utilisée avec plusieurs services et plusieurs sources de données.The same gateway can be used with multiple services, and multiple data sources. Par conséquent, il vous suffira peut-être d’installer la passerelle une seule fois. So, you may only need to install the gateway once.

  • Installez le client Oracle sur l’ordinateur où vous avez installé la passerelle de données locale.Install the Oracle Client on the machine where you installed the on-premises data gateway. Veillez à installer le fournisseur de données Oracle 64 bits pour .NET à partir d’Oracle : Be sure to install the 64-bit Oracle Data Provider for .NET from Oracle:

    ODAC 12C version 4 (12.1.0.2.4) 64 bits pour Windows x6464-bit ODAC 12c Release 4 (12.1.0.2.4) for Windows x64

    Conseil

    Si le client Oracle n’est pas installé, une erreur se produit lorsque vous tentez de créer ou d’utiliser la connexion.If the Oracle client is not installed, an error occurs when you try to create or use the connection. Consultez les erreurs courantes dans cet article.See the common errors in this article.

Ajouter le connecteurAdd the connector

Important

Ce connecteur ne possède aucun déclencheur.This connector does not have any triggers. Il possède uniquement des actions.It has only actions. Par conséquent, lorsque vous créez votre application logique, ajoutez un autre déclencheur pour démarrer votre application logique, comme Planification - Périodicité ou Requête/réponse - Réponse.So when you create your logic app, add another trigger to start your logic app, such as Schedule - Recurrence, or Request / Response - Response.

  1. Dans le portail Azure, créez une application logique vide.In the Azure portal, create a blank logic app.

  2. Au lancement de votre application logique, sélectionnez le déclencheur Requête/réponse - Requête :At the start of your logic app, select the Request / Response - Request trigger:

  3. Sélectionnez Enregistrer.Select Save. Au moment de l’enregistrement, une URL de requête est générée automatiquement.When you save, a request URL is automatically generated.

  4. Sélectionnez Nouvelle étape, puis sélectionnez Ajouter une action.Select New step, and select Add an action. Entrez oracle pour afficher les actions disponibles :Type in oracle to see the available actions:

    Conseil

    C’est également le moyen le plus rapide de voir les déclencheurs et les actions disponibles pour n’importe quel connecteur.This is also the quickest way to see the triggers and actions available for any connector. Entrez une partie du nom du connecteur, comme oracle.Type in part of the connector name, such as oracle. Le concepteur répertorie tous les déclencheurs et toutes les actions.The designer lists any triggers and any actions.

  5. Sélectionnez l’une des actions, comme Base de données Oracle - Obtenir une ligne.Select one of the actions, such as Oracle Database - Get row. Sélectionnez l’option Se connecter via la passerelle de données locale.Select Connect via on-premises data gateway. Entrez le nom du serveur Oracle, la méthode d’authentification, le nom d’utilisateur et le mot de passe, puis sélectionnez la passerelle :Enter the Oracle server name, authentication method, username, password, and select the gateway:

  6. Une fois connecté, sélectionnez une table dans la liste et entrez l’ID de ligne pour votre table.Once connected, select a table from the list, and enter the row ID to your table. Vous devez connaître l’identificateur de la table.You need to know the identifier to the table. Si vous ne le connaissez pas, contactez votre administrateur de base de données Oracle et récupérez la sortie à partir de select * from yourTableName.If you don't know, contact your Oracle DB administrator, and get the output from select * from yourTableName. Vous disposerez ainsi des informations d’identification nécessaires pour continuer.This gives you the identifiable information you need to proceed.

    Dans l’exemple suivant, les données de travail sont renvoyées à partir d’une base de données Ressources humaines :In the following example, job data is being returned from a Human Resources database:

  7. Dans l’étape suivante, vous pouvez utiliser l’un des autres connecteurs pour créer votre workflow.In this next step, you can use any of the other connectors to build your workflow. Si vous souhaitez tester l’obtention de données à partir d’Oracle, envoyez-vous un courrier électronique contenant les données Oracle à l’aide de l’un des connecteurs d’envoi de courriers électroniques, comme Office 365 ou Gmail.If you want to test getting data from Oracle, then send yourself an email with the Oracle data using one of the send email connectors, such Office 365 or Gmail. Utilisez les jetons dynamiques de la table Oracle pour créer les éléments Subject et Body de votre message électronique :Use the dynamic tokens from the Oracle table to build the Subject and Body of your email:

  8. Enregistrez votre application logique, puis sélectionnez Exécuter.Save your logic app, and then select Run. Fermez le concepteur et consultez l’état de l’historique des exécutions.Close the designer, and look at the runs history for the status. En cas d’échec, sélectionnez la ligne du message ayant échoué.If it fails, select the failed message row. Le concepteur s’ouvre et affiche l’étape qui a échoué ainsi que les informations d’erreur.The designer opens, and shows you which step failed, and also shows the error information. En cas de réussite, vous devez recevoir un courrier électronique contenant les informations que vous avez ajoutées.If it succeeds, then you should receive an email with the information you added.

Idées de workflowWorkflow ideas

  • Vous souhaitez surveiller le hashtag #oracle et inclure les tweets dans une base de données afin de pouvoir les consulter et les utiliser dans d’autres applications.You want to monitor the #oracle hashtag, and put the tweets in a database so they can be queried, and used within other applications. Dans une application logique, ajoutez le déclencheur Twitter - When a new tweet is posted, puis entrez le hashtag #oracle.In a logic app, add the Twitter - When a new tweet is posted trigger, and enter the #oracle hashtag. Ajoutez ensuite l’action Oracle Database - Insert row, puis sélectionnez votre table :Then, add the Oracle Database - Insert row action, and select your table:

  • Les messages sont envoyés à une file d’attente Service Bus.Messages are sent to a Service Bus queue. Vous souhaitez récupérer ces messages et les inclure dans une base de données.You want to get these messages, and put them in a database. Dans une application logique, ajoutez le déclencheur Service Bus - when a message is received in a queue, puis sélectionnez la file d’attente.In a logic app, add the Service Bus - when a message is received in a queue trigger, and select the queue. Ajoutez ensuite l’action Oracle Database - Insert row, puis sélectionnez votre table :Then, add the Oracle Database - Insert row action, and select your table:

Erreurs courantesCommon errors

Erreur : La passerelle est injoignable.Error: Cannot reach the Gateway

Cause : La passerelle de données locale n’est pas en mesure de se connecter au cloud.Cause: The on-premises data gateway is not able to connect to the cloud. 

Atténuation : Assurez-vous que votre passerelle s’exécute sur l’ordinateur local où vous l’avez installée, et qu’elle peut se connecter à Internet.Mitigation: Make sure your gateway is running on the on-premises machine where you installed it, and that it can connect to the internet.  Nous vous recommandons ne pas installer la passerelle sur un ordinateur susceptible d’être mis hors tension ou en veille.  We recommend not installing the gateway on a computer that may be turned off or sleep. Vous pouvez également redémarrer le service de passerelle de données locale (PBIEgwService). You can also restart the on-premises data gateway service (PBIEgwService).

Erreur : Le fournisseur utilisé est déconseillé : System.Data.OracleClient requiert le logiciel client Oracle version 8.1.7 ou supérieure.Error: The provider being used is deprecated: 'System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.'. Consultez https://go.microsoft.com/fwlink/p/?LinkID=272376 pour installer le fournisseur officiel.See https://go.microsoft.com/fwlink/p/?LinkID=272376 to install the official provider.

Cause : Le kit de développement du client Oracle n’est pas installé sur l’ordinateur qui exécute la passerelle de données locale.Cause: The Oracle client SDK is not installed on the machine where the on-premises data gateway is running. 

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.Resolution: Download and install the Oracle client SDK on the same computer as the on-premises data gateway.

Erreur : La table « [Tablename] » ne définit aucune colonne clé.Error: Table '[Tablename]' does not define any key columns

Cause : La table n’a pas de clé primaire.Cause: The table does not have any primary key. 

Résolution : Le connecteur Oracle Database requiert une table avec une colonne clé primaire.Resolution: The Oracle Database connector requires that a table with a primary key column be used.

Actuellement non pris en chargeCurrently not supported

  • Les vuesViews 
  • Toute table avec des clés compositesAny table with composite keys
  • Types d’objet imbriqués dans des tablesNested object types in tables

Détails spécifiques du connecteurConnector-specific details

Consultez l’ensemble des déclencheurs et actions définis dans le swagger, ainsi que les éventuelles limites dans les détails des connecteurs.View any triggers and actions defined in the swagger, and also see any limits in the connector details.

Obtenir de l’aideGet some help

Le Forum Azure Logic Apps est l’endroit idéal pour poser des questions, répondre aux questions posées et découvrir ce que font les autres utilisateurs de Logic Apps.The Azure Logic Apps forum is a great place to ask questions, answer questions, and see what other Logic Apps users are doing.

Vous pouvez améliorer Logic Apps et les connecteurs en votant et en soumettant vos idées sur https://aka.ms/logicapps-wish.You can help improve Logic Apps and connectors by voting and submitting your ideas at https://aka.ms/logicapps-wish.

Étapes suivantesNext steps

Créer une application logique et explorez les connecteurs disponibles dans Logic Apps sur la liste d’API.Create a logic app, and explore the available connectors in Logic Apps at APIs list.