Introduzione al connettore Oracle DatabaseGet started with the Oracle Database connector

Usando il connettore Oracle Database, è possibile creare flussi di lavoro dell'organizzazione che usano i dati nel database esistente.Using the Oracle Database connector, you create organizational workflows that use data in your existing database. Questo connettore può connettersi a un'istanza locale di Oracle Database o a una macchina virtuale di Azure con Oracle Database installato.This connector can connect to an on-premises Oracle Database, or an Azure virtual machine with Oracle Database installed. Con questo connettore è possibile:With this connector, you can:

  • Creare il flusso di lavoro aggiungendo un nuovo cliente in un database di clienti o aggiornando un ordine in un database di ordini.Build your workflow by adding a new customer to a customers database, or updating an order in an orders database.
  • Usare le azioni per ottenere una riga di dati, inserire una nuova riga e persino eliminare una riga.Use actions to get a row of data, insert a new row, and even delete. Quando ad esempio viene creato un record in Dynamics CRM Online (trigger), è possibile inserire una riga in Oracle Database (azione).For example, when a record is created in Dynamics CRM Online (a trigger), then insert a row in an Oracle Database (an action).

Questo argomento illustra come usare il connettore Oracle Database in un'app per la logica.This topic shows you how to use the Oracle Database connector in a logic app.

PrerequisitiPrerequisites

  • Versioni di Oracle supportate:Supported Oracle versions:

    • Oracle 9 e versioni successiveOracle 9 and later
    • Software client Oracle 8.1.7 e versioni successiveOracle client software 8.1.7 and later
  • Installare il gateway dati locale.Install the on-premises data gateway. Questi passaggi sono illustrati in Connettersi ai dati locali dalle app per la logica.Connect to on-premises data from logic apps lists the steps. Il gateway è necessario per connettersi a un'istanza locale di Oracle Database o a una VM di Azure con Oracle DB installato.The gateway is required to connect to an on-premises Oracle Database, or an Azure VM with Oracle DB installed.

    Nota

    Il gateway dati locale svolge la funzione di bridge e consente il trasferimento sicuro dei dati tra i dati locali (non nel cloud) e le app per la logica.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. Lo stesso gateway può essere anche usato con più servizi e più origini dati.The same gateway can be used with multiple services, and multiple data sources. Potrebbe quindi essere necessario installare il gateway una sola volta.So, you may only need to install the gateway once.

  • Installare il client Oracle nella macchina in cui è stato installato il gateway dati locale.Install the Oracle Client on the machine where you installed the on-premises data gateway. Assicurarsi di installare il provider di dati Oracle a 64 bit per .NET da Oracle:Be sure to install the 64-bit Oracle Data Provider for .NET from Oracle:

    ODAC 64 bit 12c versione 4 (12.1.0.2.4) per Windows x6464-bit ODAC 12c Release 4 (12.1.0.2.4) for Windows x64

    Suggerimento

    Se il client Oracle non è installato, si verifica un errore quando si cerca di creare o usare la connessione.If the Oracle client is not installed, an error occurs when you try to create or use the connection. Vedere gli errori comuni in questo argomento.See the common errors in this topic.

Aggiungere il connettoreAdd the connector

Importante

Questo connettore non include trigger.This connector does not have any triggers. Ha solo azioni.It has only actions. Quando si crea l'app per la logica, aggiungere quindi un altro trigger per avviare l'app per la logica, ad esempio Pianificazione - Ricorrenza o Richiesta/Risposta - Risposta.So when you create your logic app, add another trigger to start your logic app, such as Schedule - Recurrence, or Request / Response - Response.

  1. Nel portale di Azure creare un'app per la logica vuota.In the Azure portal, create a blank logic app.

  2. All'avvio dell'app per la logica, selezionare il trigger Richiesta/Risposta - Risposta:At the start of your logic app, select the Request / Response - Request trigger:

  3. Selezionare Salva.Select Save. Quando si salva, viene generato automaticamente un URL di richiesta.When you save, a request URL is automatically generated.

  4. Selezionare Nuovo passaggio e quindi Aggiungi un'azione.Select New step, and select Add an action. Digitare oracle per visualizzare le azioni disponibili:Type in oracle to see the available actions:

    Suggerimento

    Questo è anche il modo più rapido per visualizzare i trigger e le azioni disponibili per i connettori.This is also the quickest way to see the triggers and actions available for any connector. Digitare parte del nome del connettore, ad esempio oracle.Type in part of the connector name, such as oracle. La finestra di progettazione elenca i trigger e le azioni.The designer lists any triggers and any actions.

  5. Selezionare una delle azioni, ad esempio Oracle Database - Ottieni riga.Select one of the actions, such as Oracle Database - Get row. Selezionare Connect via on-premises data gateway (Connetti tramite gateway dati locale).Select Connect via on-premises data gateway. Immettere il nome del server Oracle, il metodo di autenticazione, il nome utente e la password e selezionare il gateway:Enter the Oracle server name, authentication method, username, password, and select the gateway:

  6. Una volta stabilita la connessione, selezionare una tabella nell'elenco e immettere l'ID di riga per la tabella.Once connected, select a table from the list, and enter the row ID to your table. È necessario conoscere l'identificatore della tabella.You need to know the identifier to the table. Se non lo si conosce, contattare l'amministratore di Oracle DB e ottenere l'output di select * from yourTableName.If you don't know, contact your Oracle DB administrator, and get the output from select * from yourTableName. In questo modo si otterranno le informazioni di identificazione necessarie per procedere.This gives you the identifiable information you need to proceed.

    Nell'esempio seguente i dati del processo vengono restituiti da un database delle risorse umane:In the following example, job data is being returned from a Human Resources database:

  7. Nel passaggio successivo è possibile usare uno qualsiasi degli altri connettori per creare il flusso di lavoro.In this next step, you can use any of the other connectors to build your workflow. Se si vuole provare a recuperare i dati da Oracle, inviare a se stessi un messaggio di posta elettronica con i dati di Oracle usando uno dei connettori di invio di posta elettronica, ad esempio Office 365 o 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. Usare i token dinamici della tabella Oracle per creare Subject e Body del messaggio di posta elettronica:Use the dynamic tokens from the Oracle table to build the Subject and Body of your email:

  8. Salvare l'app per la logica e quindi selezionare Esegui.Save your logic app, and then select Run. Chiudere la finestra di progettazione ed esaminare lo stato nella cronologia delle esecuzioni.Close the designer, and look at the runs history for the status. In caso di esito negativo, selezionare la riga relativa al messaggio non inviato.If it fails, select the failed message row. La finestra di progettazione viene aperta e mostra il passaggio non riuscito, con le informazioni sull'errore.The designer opens, and shows you which step failed, and also shows the error information. In caso di esito positivo, si dovrebbe ricevere un messaggio di posta elettronica con le informazioni aggiunte.If it succeeds, then you should receive an email with the information you added.

Idee per i flussi di lavoroWorkflow ideas

  • Si vuole monitorare l'hashtag #oracle e inserire i Tweet in un database in modo che sia possibile eseguire query su di essi e usarli in altre applicazioni.You want to monitor the #oracle hashtag, and put the tweets in a database so they can be queried, and used within other applications. In un'app per la logica aggiungere il trigger Twitter - When a new tweet is posted e immettere l'hashtag #oracle.In a logic app, add the Twitter - When a new tweet is posted trigger, and enter the #oracle hashtag. Aggiungere quindi l'azione Oracle Database - Insert row e selezionare la tabella:Then, add the Oracle Database - Insert row action, and select your table:

  • Messaggi inviati a una coda del bus di servizio.Messages are sent to a Service Bus queue. Si vuole ottenere questi messaggi e inserirli in un database.You want to get these messages, and put them in a database. In un'app per la logica aggiungere il trigger Service Bus - when a message is received in a queue e selezionare la coda.In a logic app, add the Service Bus - when a message is received in a queue trigger, and select the queue. Aggiungere quindi l'azione Oracle Database - Insert row e selezionare la tabella:Then, add the Oracle Database - Insert row action, and select your table:

Errori comuniCommon errors

Errore: Non è possibile raggiungere il gatewayError: Cannot reach the Gateway

Causa: il gateway dati locale non è in grado di connettersi al cloud.Cause: The on-premises data gateway is not able to connect to the cloud.

Mitigazione: assicurarsi che il gateway sia in esecuzione nel computer locale in cui è stato installato e che sia in grado di connettersi a 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. È consigliabile non installare il gateway in un computer che potrebbe venire spento o andare in sospensione.We recommend not installing the gateway on a computer that may be turned off or sleep. È anche possibile riavviare il servizio gateway dati locale (PBIEgwService).You can also restart the on-premises data gateway service (PBIEgwService).

Errore: Il provider usato è deprecato: 'System.Data.OracleClient richiede il software client Oracle versione 8.1.7 o versione successiva.'Error: The provider being used is deprecated: 'System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.'. Visitare il sito https://go.microsoft.com/fwlink/p/?LinkID=272376 per installare il provider ufficiale.Please visit https://go.microsoft.com/fwlink/p/?LinkID=272376 to install the official provider.

Causa: Oracle client SDK non è installato nel computer in cui è in esecuzione il gateway dati locale.Cause: The Oracle client SDK is not installed on the machine where the on-premises data gateway is running.

Risoluzione: scaricare e installare Oracle client SDK nello stesso computer del gateway dati locale.Resolution: Download and install the Oracle client SDK on the same computer as the on-premises data gateway.

Errore: La tabella '[NomeTabella]' non definisce alcuna colonna chiaveError: Table '[Tablename]' does not define any key columns

Causa: la tabella non ha alcuna chiave primaria.Cause: The table does not have any primary key.

Risoluzione: il connettore Oracle Database richiede l'uso di una tabella con una colonna chiave primaria.Resolution: The Oracle Database connector requires that a table with a primary key column be used.

Attualmente non supportatiCurrently not supported

  • Viste e stored procedureViews and stored procedures
  • Tabelle con chiavi composteAny table with composite keys
  • Tipi di oggetti annidati nelle tabelleNested object types in tables

Dettagli specifici del connettoreConnector-specific details

Per visualizzare eventuali azioni e trigger definiti in Swagger ed eventuali limiti, vedere i dettagli del connettore.View any triggers and actions defined in the swagger, and also see any limits in the connector details.

Ottenere aiutoGet some help

Il forum di App per la logica di Azure è il posto ideale per porre domande, fornire risposte e vedere cosa stanno facendo gli altri utenti di App per la logica.The Azure Logic Apps forum is a great place to ask questions, answer questions, and see what other Logic Apps users are doing.

È possibile migliorare App per la logica e i connettori votando e inviando le idee nella pagina http://aka.ms/logicapps-wish.You can help improve Logic Apps and connectors by voting and submitting your ideas at http://aka.ms/logicapps-wish.

Passaggi successiviNext steps

Creare un'app per la logica e scoprire i connettori disponibili in App per la logica nell'elenco di API.Create a logic app, and explore the available connectors in Logic Apps at our APIs list.