Freigeben über

Oracle-Datenbank

Oracle Database ist ein relationales Datenbankmanagementsystem, das von Oracle entwickelt wurde. Stellen Sie eine Verbindung mit der lokalen Oracle-Datenbank her, um verschiedene Aktionen wie Erstellen, Aktualisieren, Abrufen und Löschen in Zeilen in einer Tabelle auszuführen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen
Power Automate Premium Alle Power Automate-Regionen
Kontakt
Name Microsoft
URL Microsoft LogicApps-Unterstützung
Microsoft Power Automate-Support
Microsoft Power Apps-Unterstützung
Connectormetadaten
Herausgeber Microsoft
Webseite https://www.oracle.com/database/
Datenschutzrichtlinie https://www.oracle.com/legal/privacy/

In diesem Artikel werden die Vorgänge für den Oracle Database-Connector beschrieben, der für Azure Logic Apps, Microsoft Power Apps und Microsoft Power Automate verfügbar ist. Sie können diesen Connector verwenden, um eine Verbindung mit einer lokalen Oracle-Datenbank oder einem virtuellen Azure-Computer herzustellen, auf dem Oracle Database installiert ist.

Neuerungen

In der folgenden Tabelle werden die neuen Updates und Funktionen für oracle Databaseconnector beschrieben:

Update Description
Oktober 2018 Unterstützt die gespeicherte Oracle-Prozedur.
Januar 2018 Unterstützt Oracle-Ansicht als schreibgeschützte Tabelle.

Voraussetzungen

  • Unterstützte Oracle-Versionen:

    • Oracle 9 und höher
    • Oracle Data Access Client (ODAC) 11.2 und höher

  • Um eine Verbindung mit einer lokalen Oracle-Datenbank oder einem virtuellen Azure-Computer herzustellen, auf dem Oracle Database installiert ist, müssen Sie das lokale Datengateway installieren.

    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, was bedeutet, dass Sie das Gateway möglicherweise nur einmal installieren müssen.

  • Installieren Sie Ihren Oracle-Client auf dem Computer, auf dem Sie das lokale Datengateway installiert haben. Stellen Sie sicher, dass Sie den 64-Bit-Oracle-Datenanbieter für .NET aus Oracle installieren und die Windows Installer-Version auswählen, da die xcopy Version nicht mit dem lokalen Datengateway funktioniert: 64-Bit ODAC 12c Release 4 (12.1.0.2.4) für Windows x64. Sie können die Installation überprüfen, indem Sie den folgenden PowerShell-Befehl ausführen: [System.Data.Common.DbProviderFactories]::GetFactoryClasses(). Wenn ein Oracle Client installiert ist, sollte "OracleClient Data Provider" in den Ergebnissen angezeigt werden.

    Hinweis

    Wenn der Oracle-Client nicht installiert ist, tritt ein Fehler auf, wenn Sie versuchen, die Verbindung zu erstellen oder zu verwenden. Weitere Informationen finden Sie im Abschnitt "Häufige Verbindungsfehler".

  • Legen Sie vor dem Ausführen von Connectorvorgängen auf Ihrem Oracle-Client die Umgebungsvariable mit dem Namen ORA_NCHAR_LITERAL_REPLACEauf TRUE fest.

    Diese Einstellung ermöglicht die NCHAR-Zeichenfolgenliteralersetzung, wodurch Datenverlust verhindert wird, wenn Zeichenfolgenliterale, die Zeichen enthalten, die Zeichen über den Datenbankzeichensatz hinaus in die Spalte "NCHAR/NVARCHAR/NCLOB " eingefügt werden. Wenn die Anweisung ausgeführt wird, werden Zeichenfolgenliterale in ein internes Format konvertiert und dann ordnungsgemäß in Unicode decodiert.

Bekannte Probleme und Einschränkungen

In der folgenden Liste werden einige bekannte Einschränkungen für den Oracle Datbase-Connector beschrieben:

  • Nicht unterstützt:

    • Eine beliebige Tabelle mit zusammengesetzten Schlüsseln
    • Geschachtelte Objekttypen in Tabellen
    • Datenbankfunktionen mit nicht skalaren Werten
    • Oracle-Funktionen, sodass sie nicht in der Benutzeroberfläche aufgeführt sind.

  • Wenn Sie eine gespeicherte Prozedur auf einem Oracle-Server aufrufen, gelten die folgenden Einschränkungen:

    • OUT-Parameter werden nicht unterstützt.
    • Der Rückgabewert ist nicht verfügbar, da die gespeicherte Prozedur keine Ergebnisse zurückgibt.

  • Der Grenzwert für die Antwortgröße beträgt 8 MB.

  • Die Anforderungsgrößenbeschränkung beträgt 2 MB.

  • Oracle Native Query wird mit den folgenden Einschränkungen unterstützt:

    • Erfordert Gatewayversion 3000.63.4 (Version vom Oktober) oder höher.
    • RefCursor wird nicht unterstützt.
    • OUT-Parameter werden nicht unterstützt.
    • Es kann nur ein Resultset zurückgegeben werden.

  • Die folgenden Datentypen können nicht als Abfrageoptions-Prädikate verwendet werden:

    • DATE
    • TIMESTAMP
    • TIMESTAMP mit Zeitzone
    • TIMESTAMP mit lokaler Zeitzone

  • Wenn eine Oracle-Abfrage oder eine gespeicherte Prozedurausführung 110 Sekunden überschreitet, wird das Zeitlimit für die Aktion überschritten.

  • Einfügen und Aktualisieren in eine Tabelle geben nicht das vollständige Element zurück. Sie geben nur die Eingabeeigenschaften für den Vorgang zurück.

  • Um deterministische Auslagerungsergebnisse für den Vorgang " Zeilen abrufen " abzurufen, ist ein Primärschlüssel erforderlich.

  • Für den Vorgang "Zeile einfügen " müssen Sie einen expliziten Wert für die Primärschlüsselspalte angeben, obwohl der Standard-/Autoinkrementierungswert definiert ist.

  • Aufgrund von Einschränkungen der Ui-Komponente kann die Liste der tabellen, die während der Entwurfszeit gerendert werden, nicht mehr als 2.048 Elemente anzeigen, was die Standardseitengröße für den Vorgang " Tabellen abrufen " ist, z. B.:

    • Liste der Tabellen für den Aktionsparameter " Zeilen abrufen " mit dem Namen "Tabellenname".
    • Liste der Tabellen für den Fluss "Verbindung erstellen/Tabelle auswählen" im Power Apps-Designer.

  • Wenn Sie beim Arbeiten mit der Oracle-Datenbank Latenz beobachten, installieren Sie die neuesten 64-Bit-Oracle Data Access Components (ODAC) auf dem Gatewaycomputer oder jedem Gatewaycomputer, wenn das Gateway ein Cluster ist.

  • Wenn die Erstellung einer Oracle-Verbindung mit einem Timeout fehlschlägt, versuchen Sie, eine Oracle-Anmeldeinformationen mit minimaler Berechtigung zu verwenden. Auf diese Weise ist die Verbindung einfacher, was Ihnen dabei helfen kann, das Timeout während der Verbindungserstellung zu vermeiden.

Häufige Verbindungsfehler

Fehler: Das Gateway kann nicht erreicht werden.

Ursache: Das lokale Datengateway kann keine Verbindung mit der Cloud herstellen.

Entschärfung: Stellen Sie sicher, dass Ihr Gateway auf dem lokalen Computer ausgeführt wird, auf dem Sie das Gateway installiert haben und über eine Internetverbindung verfügen. Vermeiden Sie die Installation des Gateways auf einem Computer, der möglicherweise deaktiviert ist oder in den Energiesparmodus wechselt. Sie können auch versuchen, den lokalen Datengatewaydienst (PBIEgwService) neu zu starten.

Fehler: Der verwendete Anbieter ist veraltet: 'System.Data.OracleClient erfordert Oracle-Clientsoftware version 8.1.7 oder höher.'. Sehen Sie https://go.microsoft.com/fwlink/p/?LinkID=272376 sich die Installation des offiziellen Anbieters an.

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 wie das lokale Datengateway herunter, und installieren Sie es.

Fehler: Tabelle '[Tabellenname]' definiert keine Schlüsselspalten

Ursache: Die Tabelle hat keinen Primärschlüssel.

Lösung: Der Oracle Database-Connector erfordert, dass Sie eine Tabelle mit einer Primärschlüsselspalte verwenden.

Allgemeine Grenzwerte

Name Wert
Maximale Anzahl von Anforderungen, die vom Connector gleichzeitig pro Verbindung verarbeitet werden 200
Maximale Anzahl von Megabytes, die gleichzeitig über den Connector pro Verbindung übertragen werden 30

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:
Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Freigabefähig

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente

Name Typ Description Erforderlich
Server Schnur Geben Sie den Oracle Server an. Wenn ein Port oder eine SID erforderlich ist, geben Sie in Form von ServerName:Port/SID an. Richtig
Authentifizierungstyp [Standard auswählen] Schnur Authentifizierungstyp zum Herstellen einer Verbindung mit Ihrer Datenbank
Nutzername securestring Anmeldeinformationen für Benutzernamen Richtig
Kennwort securestring Kennwortanmeldeinformationen Richtig
Gateway gatewaySetting Lokales Gateway (weitere Details finden Sie unter https://docs.microsoft.com/data-integration/gateway Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 1500 60 Sekunden

Aktionen

Abrufen von Tabellen

Dieser Vorgang ruft Tabellen aus einer Datenbank ab.
Abrufen von Zeilen

Dieser Vorgang ruft Zeilen aus einer Tabelle ab.
Ausführen einer gespeicherten Prozedur

Dieser Vorgang führt eine gespeicherte Prozedur aus.
Ausführen einer Oracle-Abfrage

Ausführen einer Oracle-Abfrage
Zeile abrufen

Dieser Vorgang ruft eine Zeile aus einer Tabelle ab.
Zeile aktualisieren

Dieser Vorgang aktualisiert eine vorhandene Zeile in einer Tabelle.
Zeile einfügen

Dieser Vorgang fügt eine neue Zeile in eine Tabelle ein.
Zeile löschen

Dieser Vorgang löscht eine Zeile aus einer Tabelle.

Abrufen von Tabellen

Vorgangs-ID:
GetTables

Dieser Vorgang ruft Tabellen aus einer Datenbank ab.

Gibt zurück

Stellt eine Liste von Tabellen dar.

Body
TablesList

Abrufen von Zeilen

Vorgangs-ID:
GetItems

Dieser Vorgang ruft Zeilen aus einer Tabelle ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Tabellenname
 table True string

Name der Oracle-Tabelle
Filterabfrage
 $filter string

Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Bestellung nach
 $orderby string

Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge.
Höchste Anzahl
 $top integer

Gesamtzahl der abzurufenden Einträge (Standard = alle).
Anzahl überspringen
 $skip integer

Die Anzahl der zu überspringenden Einträge (Standard = 0).
Abfrage auswählen
 $select string

Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Ausführen einer gespeicherten Prozedur

Vorgangs-ID:
ExecuteProcedure

Dieser Vorgang führt eine gespeicherte Prozedur aus.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Prozedurname
 procedure True string

Name der gespeicherten Prozedur
Parameterliste
 parameters True dynamic

Eingabeparameter für die gespeicherte Prozedur

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Ausführen einer Oracle-Abfrage

Vorgangs-ID:
ExecutePassThroughNativeQuery

Ausführen einer Oracle-Abfrage

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Query
 query True dynamic

Abfragetext

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile abrufen

Vorgangs-ID:
GetItem

Dieser Vorgang ruft eine Zeile aus einer Tabelle ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Tabellenname
 table True string

Name der Oracle-Tabelle
Zeilen-ID
 id True string

Eindeutiger Bezeichner der abzurufenden Zeile

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile aktualisieren

Vorgangs-ID:
PatchItem

Dieser Vorgang aktualisiert eine vorhandene Zeile in einer Tabelle.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Tabellenname
 table True string

Name der Tabelle
Zeilen-ID
 id True string

Eindeutiger Bezeichner der zu aktualisierenden Zeile
Zeile
 item True dynamic

Zeile mit aktualisierten Werten

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile einfügen

Vorgangs-ID:
PostItem

Dieser Vorgang fügt eine neue Zeile in eine Tabelle ein.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Tabellenname
 table True string

Name der Tabelle
Zeile
 item True dynamic

Zeile, die in die angegebene Tabelle eingefügt werden soll

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile löschen

Vorgangs-ID:
DeleteItem

Dieser Vorgang löscht eine Zeile aus einer Tabelle.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Tabellenname
 table True string

Name der Tabelle
Zeilen-ID
 id True string

Eindeutiger Bezeichner der zu löschenden Zeile

Definitionen

Table

Stellt eine Tabelle dar.

Name Pfad Typ Beschreibung
Name
 Name string

Der Name der Tabelle. Der Name wird zur Laufzeit verwendet.
Anzeigename
 DisplayName string

Der Anzeigename der Tabelle.
DynamicProperties
 DynamicProperties object

Zusätzliche Tabelleneigenschaften, die vom Connector für die Clients bereitgestellt werden.

TablesList

Stellt eine Liste von Tabellen dar.

Name Pfad Typ Beschreibung
value
 value array of Table

Liste der Tabellen