Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Azure Logic Apps (Verbrauch + Standard)
Wenn Ihre Workflows mit Oracle-Daten arbeiten müssen, stellen Sie mithilfe der Oracle Database Connector in Azure Logic Apps eine Verbindung mit Ihrer Oracle-Datenbank her. Sie können auf Datenbanken zugreifen, die entweder lokal oder auf einem Azure virtuellen Computer gehostet werden.
Der Oracle Database Connector hilft Ihnen bei der Lösung allgemeiner Datenintegrationsaufgaben, z. B.:
- Fügen Sie Ihrer Datenbank Kundendatensätze hinzu.
- Aktualisieren Sie Die Bestelldatensätze in Ihrer Datenbank.
- Abrufen, Einfügen oder Löschen von Tabellenzeilen als Teil Ihres Workflows.
Unterstützte Oracle-Datenbankversionen
In der folgenden Tabelle sind die unterstützten Oracle DB-Versionen aufgeführt, die von jedem Connector unterstützt werden:
| Connector | Logik-App | Unterstützte Oracle DB-Versionen |
|---|---|---|
| Verwaltet | -Verbrauch -Standard |
- Oracle 9 und höher - Oracle Data Access Client (ODAC) 11.2 und höher |
| Eingebaut (Vorschau) | Standard | Oracle Database 11 und höher |
Technische Referenz für den Steckverbinder
Der Oracle Database-Connector verfügt über unterschiedliche Versionen, basierend auf dem Workflowtyp und der Hostumgebung der Logik-App.
| Logik-App | Umgebung | Connector-Version |
|---|---|---|
| Verbrauch | Azure Logic Apps mit mehreren Mandanten | Verwalteter Connector, der im Connectorkatalog unter dem Filter Freigegeben angezeigt wird. Weitere Informationen finden Sie unter Oracle Database managed connector reference. |
| Standard | Einzelmandanten-Azure Logic Apps, App Service-Umgebung v3 (nur Windows-Pläne) und Hybrid | Verwalteter Connector, der im Connectorkatalog unter dem freigegebenen Filter angezeigt wird, und integrierter Connector (öffentliche Vorschau), der im Connectorkatalog unter dem integrierten Filter angezeigt wird. Die integrierte Version wird innerhalb der Azure Logic Apps-Laufzeit ausgeführt und erfordert kein lokales Daten-Gateway, da die Laufzeit Ihren Oracle-Endpunkt über das Netzwerk erreichen kann. Weitere Informationen finden Sie unter: - Referenz zu verwaltetem Oracle Database-Connector - Referenz für integrierte Konnektoren |
Integrierte Connectorvorgänge (Vorschau)
Der integrierte Connector unterstützt derzeit die folgenden Aktionen:
| Name | Parameter | Description | Rücklieferungen |
|---|---|---|---|
Abfrage ausführen (executeQuery) |
-
Abfrage (query): Erforderlich vom string Typ. Die auszuführende SQL-Abfrage. - Abfrageparameter ( queryParameters): Optional mit Typ object. Die einzuschließden Abfrageparameter. |
Führt eine SQL-Abfrage aus. | Das SQL-Abfrageergebnis als array. |
Gespeicherte Prozedur ausführen (executeStoredProcedure) |
-
Name der gespeicherten Prozedur (storedProcedure): Erforderlich mit string Typ. Der Name der zu ausführenden gespeicherten Prozedur. - Parameter für gespeicherte Prozeduren ( storedProcedureParameters): Optional mit object Typ. Die einzuschließden Parameter der gespeicherten Prozedur. |
Führt eine gespeicherte Prozedur aus und gibt die Resultsets und Ausgabeparameter zurück. |
-
Ergebnismengen (resultSets) vom Typ string. Die Liste der von der gespeicherten Prozedur zurückgegebenen Ergebnismengen. - Ausgabeparameter ( outputParmaters) vom Typ string. Die von der gespeicherten Prozedur zurückgegebenen Ausgabeparameterwerte. |
Abrufen von Zeilen (getRows) |
-
Tabellenname (tableName): Erforderlich mit string Typ. Der Name für die Quelltabelle. - Bedingung ( columnValuesForWhereCondition): Optional mit object Typ. Das Schlüssel-Wert-Paar von Spalten, die die abzurufenden Zeilen identifizieren. - Offset für Get Rows ( skipCount): Optional mit string Typ. Die Anzahl der zu überspringenden Einträge. Standard ist "0". - Max Rows ( maxcount): Optional mit Typ string. Die maximale Anzahl der Zeilen, die abgerufen werden sollen. Standard ist "0". - Sortierspalte ( orderBy): Optional bei string-Typ. Der Spaltenname, der zum Sortieren des Abfrageergebnisses verwendet werden soll. - Spalten auswählen ( filterBy): Optional mit dem Typ string. Der Spaltenwert, der aus der Tabelle oder Ansicht abgerufen werden soll. |
Ruft eine oder mehrere Zeilen basierend auf der angegebenen Bedingung ab. | Die abgerufenen Zeilen als array. |
Abrufen von Tabellen (getTables) |
Gibt nur Tabellen zurück, die dem aktuellen Benutzer gehören (ownedTables): Optional mit string Typ. Gibt nur Tabellen zurück, in denen der Besitzer der bereitgestellte Benutzer ist. |
Ruft eine Liste von Tabellen ab. | Die Liste der Tabellen als array. |
Zeile einfügen (insertRow) |
-
Tabellenname (tableName): Erforderlich mit string Typ. Der Name der Tabelle. - Spalten einrichten ( setColumns): Optional mit object-Typ. Die Werte der Zeilenfelder. |
Fügt eine Zeile ein. | Die eingefügte Zeile mit object Typ. |
Voraussetzungen
Ein Azure Konto und ein Abonnement. Erhalten Sie ein kostenloses Azure-Konto.
Die Logik-App-Ressource und der Workflow, von wo aus eine Verbindung mit Ihrer Oracle-Datenbank hergestellt werden soll.
Dieser Connector stellt nur Aktionen und keine Trigger bereit. Sie können eine beliebigen Trigger verwenden, der Ihren Workflow starten soll. Informationen zum Erstellen der Logik-App-Ressource und des Workflows und zum Hinzufügen eines Triggers finden Sie unter:
Voraussetzungen für verwaltete Konnektoren (Verbrauch und Standard)
Laden Sie das lokale Datengateway herunter, und installieren Sie es.
Dieses Gateway fungiert als Brücke und bietet eine sichere Datenübertragung zwischen lokalen Daten und Ihrer App oder Ihrem Client. Sie können dieselbe Gatewayinstallation mit mehreren Diensten und Datenquellen verwenden, sodass Sie das Gateway möglicherweise nur einmal installieren müssen.
Installieren Sie den Oracle-Client auf dem Computer, auf dem das lokale Datengateway installiert ist. Andernfalls tritt ein Fehler auf, wenn Sie versuchen, eine Verbindung herzustellen oder diese zu verwenden.
Erstellen Sie eine Azure-Gatewayressource für Ihre Gatewayinstallation.
Integrierte Connectorvoraussetzungen (Standard, Vorschau)
Stellen Sie sicher, dass Ihr Standardlogik-App-Workflow Ihren Oracle-Endpunkt erreichen kann, einschließlich aller Host-, Port-, DNS-Auflösungs- und Firewallregeln.
Wenn Sie die Oracle-Datenbankverbindung erstellen, benötigen Sie die folgenden Werte:
- ORACLE-Datenbankserver-IP-Adresse
- Nutzername
- Kennwort
Geben Sie für die Server-IP-Adresse diesen Wert in den folgenden Formaten an:
Format Syntax Example Easy Connect (non-SSL) < host>:<port>/<database-service-name> localhost:1522/XETransparent Network Substrate (TNS)-Deskriptor (SSL): Der vollständige Oracle Datasource-Deskriptor (description=(retry_count=<retries>)(retry_delay=<delay-duration>)(address=(protocol=tcps)(port=<port-number>)(host=<host>))(connect_data=(service_name=<service-name>)))(security=(ssl_server_dn_match=yes))) (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))) Für die Aktion Zeile abrufen, die in diesem Beispiel verwendet wird, müssen Sie den Bezeichner für die Tabelle kennen, auf die zugegriffen werden soll.
Wenn Sie diese Information nicht besitzen, wenden Sie sich an Ihren Oracle Database-Administrator, oder rufen Sie die Ausgabe aus der folgenden Anweisung ab:
select * from <table-name>.
Bekannte Probleme und Einschränkungen
Die aktuellen Connectorversionen unterstützen keine Trigger. Verwenden Sie jeden Trigger, der Ihrem Szenario entspricht, um Ihren Workflow zu starten, und fügen Sie dann Oracle-Aktionen hinzu.
| Connector | Einschränkungen |
|---|---|
| Verwaltet | - Tabellen mit zusammengesetzten Schlüsseln - Tabellen mit geschachtelten Objekttypen - Datenbankfunktionen mit nichtkalaren Werten |
| Eingebaut | – Keine dedizierten Aktualisierungs- oder Löschaktionen. Verwenden Sie für Aktualisierungs- und Löschszenarien die Aktion "Abfrage ausführen" oder "Gespeicherte Prozedur ausführen". – Einige Verbindungsprobleme können nur zur Workflowlaufzeit und nicht zur Erstellungszeit der Verbindung auftreten. |
Hinzufügen einer Aktion
Die Schritte zum Hinzufügen und Verwenden einer Oracle-Aktion unterscheiden sich je nachdem, ob Sie den integrierten Connector oder verwalteten Connector verwenden.
Hinzufügen einer integrierten Connectoraktion (Standard, Vorschau)
Öffnen Sie im Azure-Portal Ihre Ressource vom Typ „Logic App (Standard)“.
Öffnen Sie im Designer Ihren Workflow.
Führen Sie die allgemeinen Schritte aus, um die Oracle Database-Aktion hinzuzufügen, die Sie Ihrem Workflow hinzufügen möchten.
In diesem Beispiel wird die Aktion " Zeilen abrufen " fortgesetzt.
Geben Sie im Verbindungsinformationsbereich die erforderlichen Informationen ein, z. B. den gewünschten Verbindungsnamen, die Oracle-Datenbankserver-IP-Adresse, den Benutzernamen und das Kennwort, z. B.:
Wählen Sie abschließend Neu erstellen aus.
Geben Sie im Aktionsinformationsbereich die Parameterwerte ein, die für die ausgewählte Aktion erforderlich sind.
Wenn Sie beispielsweise die Aktion " Zeilen abrufen " auswählen, geben Sie den Tabellennamen ein:
Fügen Sie alle weiteren Aktionen hinzu, die zum Abschließen des Workflows erforderlich sind.
Speichern Sie den Workflow. Wählen Sie auf der Symbolleiste des Designers Speichern aus.
Hinzufügen einer verwalteten Connectoraktion (Verbrauch und Standard)
Öffnen Sie im Azure-Portal Ihre Logik-App-Ressource "Consumption" oder "Standard".
Öffnen Sie im Designer Ihren Workflow.
Führen Sie die allgemeinen Schritte aus, um die Oracle Database-Aktion hinzuzufügen, die Sie Ihrem Workflow hinzufügen möchten.
Dieses Beispiel wird mit der Aktion Abrufen der Zeile fortgesetzt.
Geben Sie im Verbindungsinformationsbereich die erforderlichen Verbindungsinformationen ein.
Wählen Sie für die Gateway--Eigenschaft das zu verwendende Azure-Abonnement und die Azure-Gatewayressource aus.
Nachdem Sie die Verbindung abgeschlossen haben, wählen Sie in der Tabellennamenliste eine Tabelle aus.
Geben Sie in der Zeilen-ID-Eigenschaft die in Ihrer Tabelle gewünschte Zeilen-ID an.
Im folgenden Beispiel werden die Auftragsdaten aus einer Datenbank für das Personalmanagement zurückgegeben:
Fügen Sie alle weiteren Aktionen hinzu, die zum Abschließen des Workflows erforderlich sind.
Speichern Sie den Workflow. Wählen Sie auf der Symbolleiste des Designers Speichern aus.
Beheben von Problemen bei der Oracle-Datenbankverbindung
Fehler: Das Gateway ist nicht erreichbar.
Ursache: Das lokale Datengateway kann keine Verbindung mit der Cloud herstellen.
Lösung: Stellen Sie sicher, dass Ihr Gateway auf dem lokalen Computer ausgeführt wird, auf dem es installiert ist, und über Internetzugriff verfügt. Installieren Sie das Gateway nicht auf einem Computer, der möglicherweise ausgeschaltet wird oder in den Standbymodus versetzt wird. Sie können auch versuchen, den lokalen Datengatewaydienst (PBIEgwService) neu zu starten.
Fehler: Der verwendete Anbieter ist veraltet: „System.Data.OracleClient erfordert Version 8.1.7 oder höher der Oracle-Clientsoftware.“ Informationen zum Installieren des offiziellen Anbieters finden Sie unter https://go.microsoft.com/fwlink/p/?LinkID=272376.
Ursache: Das Oracle-Client-SDK ist nicht auf dem Computer installiert, auf dem das lokale Datengateway ausgeführt wird.
Lösung: Laden Sie das Oracle-Client-SDK auf demselben Computer herunter, auf dem sich das lokale Datengateway befindet, und installieren Sie es.
Fehler: Für die Tabelle „[Tablename]“ sind keine Schlüsselspalten definiert.
Ursache: Die Tabelle weist keinen Primärschlüssel auf.
Lösung: Der Oracle Database-Connector erfordert, dass Sie eine Tabelle mit einer Primärschlüsselspalte verwenden.