Connessione a Oracle Database da App per la logica di Azure

Articolo
01/10/2024

Si applica a: App per la logica di Azure (consumo)

Usando il connettore Oracle Database, è possibile creare flussi di lavoro dell'organizzazione che usano i dati nel database esistente. Questo connettore può connettersi a un'istanza locale di Oracle Database o a una macchina virtuale di Azure con Oracle Database installato. Con questo connettore è possibile:

Creare il flusso di lavoro aggiungendo un nuovo cliente in un database di clienti o aggiornando un ordine in un database di ordini.
Usare le azioni per ottenere una riga di dati, inserire una nuova riga e persino eliminare una riga. Quando ad esempio viene creato un record in Dynamics CRM Online (trigger), è possibile inserire una riga in Oracle Database (azione).

Questo connettore non supporta gli elementi seguenti:

Tabelle con chiavi composte
Tipi di oggetti annidati nelle tabelle
Funzioni di database con valori non scalari

Questo articolo illustra come usare il connettore Oracle Database in un'app per la logica.

Prerequisiti

Versioni di Oracle supportate:
- Oracle 9 e versioni successive
- Oracle Data Access Client (ODAC) 11.2 e versioni successive
Installare il gateway dati locale. Questi passaggi sono illustrati in Connettersi ai dati locali dalle app per la logica. Il gateway è necessario per connettersi a un'istanza locale di Oracle Database o a una VM di Azure con Oracle DB installato.

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. Lo stesso gateway può essere anche usato con più servizi e più origini dati. Potrebbe quindi essere necessario installare il gateway una sola volta.
Installare il client Oracle nella macchina in cui è stato installato il gateway dati locale. Assicurarsi di installare il provider di dati Oracle a 64 bit per .NET da Oracle e di selezionare la versione di Windows Installer perché la xcopy versione non funziona con il gateway dati locale:

ODAC 64 bit 12c versione 4 (12.1.0.2.4) per Windows x64

Suggerimento

Se il client Oracle non è installato, si verifica un errore quando si cerca di creare o usare la connessione. Vedere gli errori comuni in questo articolo.

Aggiunta del connettore

Importante

Questo connettore non include trigger. Ha solo azioni. 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.

Nel portale di Azure creare un'app per la logica vuota.
All'avvio dell'app per la logica, selezionare il trigger Richiesta/Risposta - Risposta:
Seleziona Salva. Quando si salva, viene generato automaticamente un URL di richiesta.
Selezionare Nuovo passaggio e quindi Aggiungi un'azione. Digitare oracle per visualizzare le azioni disponibili:

Suggerimento

Questo è anche il modo più rapido per visualizzare i trigger e le azioni disponibili per i connettori. Digitare parte del nome del connettore, ad esempio oracle. La finestra di progettazione elenca i trigger e le azioni.
Selezionare una delle azioni, ad esempio Oracle Database - Ottieni riga. Selezionare Connect via on-premises data gateway (Connetti tramite gateway dati locale). Immettere il nome del server Oracle, il metodo di autenticazione, il nome utente e la password e selezionare il gateway:
Una volta stabilita la connessione, selezionare una tabella nell'elenco e immettere l'ID di riga per la tabella. È necessario conoscere l'identificatore della tabella. Se non lo si conosce, contattare l'amministratore di Oracle DB e ottenere l'output di select * from yourTableName. In questo modo si otterranno le informazioni di identificazione necessarie per procedere.

Nell'esempio seguente i dati del processo vengono restituiti da un database delle risorse umane:
Nel passaggio successivo è possibile usare uno qualsiasi degli altri connettori per creare il flusso di lavoro. Per testare il recupero di dati da Oracle, inviare un messaggio di posta elettronica con i dati Oracle usando uno dei connettori di posta elettronica di invio, ad esempio Office 365 Outlook. Usare i token dinamici della tabella Oracle per creare Subject e Body del messaggio di posta elettronica:
Salvare l'app per la logica e quindi selezionare Esegui. Chiudere la finestra di progettazione ed esaminare lo stato nella cronologia delle esecuzioni. In caso di esito negativo, selezionare la riga relativa al messaggio non inviato. La finestra di progettazione viene aperta e mostra il passaggio non riuscito, con le informazioni sull'errore. In caso di esito positivo, si dovrebbe ricevere un messaggio di posta elettronica con le informazioni aggiunte.

Idee per i flussi di lavoro

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. In un'app per la logica aggiungere il trigger Twitter - When a new tweet is posted e immettere l'hashtag #oracle. Aggiungere quindi l'azione Oracle Database - Insert row e selezionare la tabella:
Messaggi inviati a una coda del bus di servizio. Si vuole ottenere questi messaggi e inserirli in un database. In un'app per la logica aggiungere il trigger Service Bus - when a message is received in a queue e selezionare la coda. Aggiungere quindi l'azione Oracle Database - Insert row e selezionare la tabella:

Errori comuni

Errore: Non è possibile raggiungere il gateway

Causa: il gateway dati locale non è in grado di connettersi al 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. È consigliabile non installare il gateway in un computer che potrebbe venire spento o andare in sospensione. È anche possibile riavviare il servizio gateway dati locale (PBIEgwService).

Errore: Il provider usato è deprecato: 'System.Data.OracleClient richiede il software client Oracle versione 8.1.7 o versione successiva.' Per installare il provider ufficiale, vedere https://go.microsoft.com/fwlink/p/?LinkID=272376.

Causa: Oracle client SDK non è installato nel computer in cui è in esecuzione il gateway dati locale.

Risoluzione: scaricare e installare Oracle client SDK nello stesso computer del gateway dati locale.

Errore: La tabella '[NomeTabella]' non definisce alcuna colonna chiave

Causa: la tabella non ha alcuna chiave primaria.

Risoluzione: il connettore Oracle Database richiede l'uso di una tabella con una colonna chiave primaria.

Dettagli specifici del connettore

Per visualizzare eventuali azioni e trigger definiti in Swagger ed eventuali limiti, vedere i dettagli del connettore.

Ottenere aiuto

La pagina di domande Microsoft per le App per la logica di Azure è il posto ideale per porre domande, aggiungere risposte e vedere cosa stanno facendo gli altri utenti delle App per la logica.

È possibile migliorare App per la logica e i connettori votando e inviando le idee nella pagina https://aka.ms/logicapps-wish.