Oracle Database

Zusammenfassung

Element	BESCHREIBUNG
Freigabezustand	Allgemeine Verfügbarkeit
Produkte	Excel Power BI (Semantikmodelle) Power BI (Datenflüsse) Fabric (Dataflow Gen2) Power Apps (Dataflows) Dynamics 365 Customer Insights Analyse-Services
Unterstützte Authentifizierungstypen	Windows (Desktop/Online) Datenbank (Desktop) Basic (online) Microsoft-Konto (Desktop)
Funktionsreferenzdokumentation	Oracle.Database

Hinweis

Einige Funktionen sind möglicherweise in einem Produkt vorhanden, jedoch nicht in anderen, was auf Bereitstellungszeitpläne und hostspezifische Funktionen zurückzuführen ist.

Voraussetzungen

Unterstützte Oracle-Versionen:

• Oracle Database Server 12c (12.1.0.2) und höher
• Oracle Autonomous Database - alle Versionen

Bevor Sie mithilfe von Power Query eine Verbindung mit einer Oracle-Datenbank herstellen können, müssen Sie den Oracle Client für Microsoft Tools (OCMT) installieren. Um eine Verbindung mit einer Oracle-Datenbank mit dem lokalen Datengateway herzustellen, muss 64-Bit-OCMT auf dem Computer installiert sein, auf dem das Gateway ausgeführt wird. Weitere Informationen hierzu können Sie unter "Datenquelle verwalten" – Oracle.

Hinweis

Seit der April 2025-Version von Power BI Desktop und der Mai 2025-Version des lokalen Datengateway bieten wir die neue Option, von dem integrierten Oracle managed ODP.NET-Treiber Gebrauch zu machen, um eine Verbindung zur Oracle-Datenbank herzustellen, die derzeit in der Vorschau verfügbar ist. Wenn das Feature aktiviert ist, müssen Sie das OCMT nicht manuell installieren. Erfahren Sie mehr über diese Funktion.

Unterstützte Funktionen

• Importieren
• DirectQuery (Power BI-Semantikmodelle)
• Erweiterte Optionen
  • Befehlstimeout in Minuten
  • SQL-Anweisung
  • Beziehungsspalten einbeziehen
  • Navigieren mithilfe der vollständigen Hierarchie

Herunterladen und Installieren von Oracle Client für Microsoft Tools

Oracle Client für Microsoft Tools installiert und konfiguriert Oracle Data Provider für .NET (ODP.NET) zur Unterstützung von 32-Bit- und 64-Bit-Microsoft-Toolverbindungen mit Oracle lokal und Clouddatenbanken, einschließlich Oracle Autonomous Database (ADB). OCMT ist ein grafisches Installationsprogramm, das den Einrichtungsprozess von Oracle Database Client automatisiert. Es unterstützt die Verbindung mit Power BI Desktop, Power BI-Dienst, Fabric (Dataflow Gen2), Excel, SQL Server Analysis Services, SQL Server Data Tools, SQL Server Integration Services, SQL Server Reporting Services und BizTalk Server.

OCMT ist kostenlose Software. Sie kann von der Seite Oracle Client für Microsoft Tools heruntergeladen werden. Verwenden Sie für den 64-Bit-Power BI-Desktop- und Power BI-Dienst 64-Bit-OCMT. Verwenden Sie für Power BI Desktop (32-Bit) 32-Bit-OCMT.

Auch wenn Sie bereits einen Oracle-Client oder ODP.NET auf Ihrem Power BI-Client installiert haben, wird dringend empfohlen, das OCMT-Installationsprogramm zu verwenden, um alle Konfigurationsschritte, die Power BI für die Zusammenarbeit mit der Oracle-Datenbank erfordert, ordnungsgemäß abzuschließen.

• OCMT 64-Bit- und 32-Bit-Downloads
• Installations- und Einrichtungsanweisungen für OCMT

Herstellen einer Verbindung mit einer lokalen Oracle-Datenbank über Power Query Desktop

Führen Sie die folgenden Schritte aus, um die Verbindung herzustellen:

1. Wählen Sie die Oracle-Datenbankoption in der Connectorauswahl aus.

2. Geben Sie den Oracle Net Service Name/TNS-Alias oder die Easy Connect (Plus)-Verbindungszeichenfolge an, mit der in Server eine Verbindung hergestellt werden soll. Easy Connect ist am einfachsten zu verwenden, indem Sie den Serverwert für Ihren Oracle-Datenbankserver Hostname/ServiceName festlegen, wobei ServiceName der globale Datenbankname ist. Der folgende Screenshot verwendet einen Netzdienstnamen.

   

3. Wenn Sie eine Verbindung über Power BI Desktop herstellen, wählen Sie entweder den Datenverbindungsmodus Import oder DirectQuery aus. In den restlichen Beispielschritten wird der Importdatenkonnektivitätsmodus verwendet. Weitere Informationen zu DirectQuery finden Sie unter Verwenden von DirectQuery in Power BI Desktop.

4. Wenn Sie zum ersten Mal eine Verbindung mit dieser Oracle-Datenbank herstellen, wählen Sie den Authentifizierungstyp aus, den Sie verwenden möchten, und geben Sie dann Ihre Anmeldeinformationen ein. Die verfügbaren Authentifizierungstypen sind:

   • Windows (Windows-Authentifizierung)
   • Datenbank (Benutzername und Kennwort)
   • Microsoft-Konto (Microsoft Entra-ID)

   Weitere Informationen zur Authentifizierung finden Sie unter Authentifizierung mit einer Datenquelle.

   

5. Wählen Sie in Navigator die gewünschten Daten aus, und wählen Sie dann entweder Laden oder Daten transformieren aus, um die Daten zu laden oder zu transformieren.

Herstellen einer Verbindung mit einer lokalen Oracle-Datenbank aus Power Query Online

Führen Sie die folgenden Schritte aus, um die Verbindung herzustellen:

1. Installieren und Einrichten eines lokalen Datengateways.

2. Wählen Sie in Power Query Online die Oracle-Datenbankoption in der Auswahl der Datenquellen aus.

3. Geben Sie im angezeigten Oracle-Datenbankdialogfeld den Oracle Net-Dienstnamen/TNS-Alias, die Easy Connect Plus-Verbindungszeichenfolge oder den Verbindungsdeskriptor für die Verbindung mit server an.

   

4. Geben Sie einen Verbindungsnamen an, z. B. "testoracleserver".

5. Wählen Sie den Namen Ihres lokalen Daten-Gateways.

   Hinweis

   Sie müssen ein lokales Datengateway für diesen Connector auswählen, unabhängig davon, ob sich die Oracle-Datenbank in Ihrem lokalen Netzwerk oder auf einer Website befindet.

6. Wenn Sie zum ersten Mal eine Verbindung mit dieser Oracle-Datenbank herstellen, wählen Sie den Typ der Anmeldeinformationen für die Verbindung in Authentifizierungsart aus. Wählen Sie "Einfach " aus, wenn Sie sich mit einem Oracle-Benutzernamen und -Kennwort anmelden möchten. Wählen Sie Windows bei Verwendung der Windows-Betriebssystemauthentifizierung und sowohl mit dem Oracle-Client als auch dem Server unter Windows aus.

7. Geben Sie Ihre Anmeldeinformationen ein.

8. Klicken Sie auf Weiter, um fortzufahren.

9. Wählen Sie in Navigator die erforderlichen Daten aus, und wählen Sie dann Daten transformieren aus, um die Daten in Power Query-Editor zu transformieren.

Herstellen einer Verbindung mit einer Oracle Autonomous Database

Hinweis

Derzeit können Sie eine Verbindung mit einer Oracle Autonomous Database aus Excel, Power BI Desktop, Power BI-Dienst, Fabric (Dataflow Gen2), Power Apps, SQL Server Analysis Services und BizTalk Server mithilfe der Verfahren in diesem Abschnitt herstellen. Diese Tools verwenden nicht verwaltete ODP.NET, um eine Verbindung herzustellen. Andere Microsoft-Tools, einschließlich SQL Server Data Tools, SQL Server Integration Services und SQL Server Reporting Services, verwenden verwaltete ODP.NET, um eine Verbindung mit Oracle Autonomous Database mithilfe weitgehend ähnlicher Verfahren herzustellen.

Um Power BI mit einer Oracle Autonomous Database zu verbinden, benötigen Sie die folgenden Konten und Apps:

• Ein Oracle.com Konto (Oracle.com Kontoanmeldung)
• Ein Oracle Cloud-Konto (Oracle Cloud Account Signup)
• Eine Oracle Autonomous Database-Instanz (Immer kostenlose Autonomous Database-Instanz abrufen)
• Power BI Desktop (Power BI Desktop abrufen) oder Power BI-Dienstkonto (Lizenzierung des Power BI-Diensts für Benutzer in Ihrer Organisation)
• Lokales Datengateway bei Verwendung des Power BI-Diensts (Herunterladen und Installieren eines Standardgateways)

Herunterladen Ihrer Clientanmeldeinformationen

Der erste Schritt beim Einrichten einer Verbindung mit der Oracle Autonomous-Datenbank besteht darin, Ihre Clientanmeldeinformationen herunterzuladen.

So laden Sie Ihre Clientanmeldeinformationen herunter:

1. Wählen Sie auf der Seite "Oracle Autonomous Database Details" die Option "DB Connection" aus.

   

2. Wählen Sie auf der Seite Datenbankverbindung die Option Wallet herunterladen aus.

   

3. Geben Sie ein Kennwort ein, das Sie mit dieser Brieftasche verwenden möchten, bestätigen Sie das Kennwort, und wählen Sie dann "Herunterladen" aus.

   

Konfigurieren von Oracle ADB-Anmeldeinformationen

1. Wechseln Sie auf Ihrem Windows-Computer zu dem Ordner, in dem Sie Ihre Oracle ADB-Anmeldeinformationen aus " Clientanmeldeinformationen herunterladen" heruntergeladen haben.

2. Entpacken Sie die Anmeldeinformationen in das Verzeichnis, das Sie in OCMT als Oracle Configuration File Directory angegeben haben. In diesem Beispiel werden die Anmeldeinformationen in "c:\data\wallet\wallet_contosomart" extrahiert.

   

   Hinweis

   Die Datei "tnsnames.ora" definiert Ihre Oracle Autonomous Database-Adresse und Verbindungsinformationen.

3. Öffnen Sie sqlnet.ora in einem Texteditor, z. B. Notepad.

4. Ändern Sie unter WALLET_LOCATION den Pfad zu Ihrem Brieftaschenordner unter der Option "Verzeichnis". In diesem Beispiel:

   WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))

5. Speichern und schließen Sie die Datei "sqlnet.ora".

Öffnen Sie die Datei "tnsnames.ora" im Ordner "Wallets". Die Datei enthält eine Liste der ADB-Netdienstnamen, mit denen Sie eine Verbindung herstellen können. In diesem Beispiel lauten die Namen folgendermaßen: contosomart_high, contosomart_low, contosomart_medium. Ihre ADB-Netzdienstnamen unterscheiden sich.

Verbinden von Power BI Desktop mit Oracle ADB

1. Öffnen Sie Power BI Desktop.

2. Wählen Sie Daten abrufenaus.

3. Wählen Sie in "Daten abrufen" die Datenbank "Oracle-Datenbank>" aus.

4. Geben Sie den Netzdienstnamen des Oracle Autonomous Database Servers ein, mit dem Sie eine Verbindung herstellen möchten. In diesem Beispiel ist der Server contosomart_high. Wählen Sie dann OK aus.

   

5. Wenn Sie sich zum ersten Mal von Power BI Desktop bei diesem Server anmelden, werden Sie aufgefordert, Ihre Anmeldeinformationen einzugeben. Wählen Sie "Datenbank" aus, und geben Sie dann den Benutzernamen und das Kennwort für die Oracle-Datenbank ein. Die anmeldeinformationen, die Sie hier eingeben, sind der Benutzername und das Kennwort für die bestimmte Oracle Autonomous Database, mit der Sie eine Verbindung herstellen möchten. In diesem Beispiel werden der anfängliche Administratorbenutzername und das Kennwort der Datenbank verwendet. Wählen Sie dann Verbinden aus.

   

   Hinweis

   Sie können die Microsoft Entra ID-Authentifizierung verwenden, um sich über die Microsoft-Kontooption bei Oracle Autonomous Database anzumelden.

An diesem Punkt wird der Navigator angezeigt und zeigt die Verbindungsdaten an.

Möglicherweise gibt es auch einen von mehreren Fehlern, da die Konfiguration nicht ordnungsgemäß eingerichtet wurde. Diese Fehler werden in der Problembehandlung erläutert.

Ein Fehler, der bei diesem anfänglichen Test auftreten kann, findet in Navigator statt, in dem die Datenbank scheinbar verbunden ist, aber keine Daten enthält. Stattdessen wird ein Oracle: ORA-28759: Fehler beim Öffnen der Datei anstelle der Daten angezeigt.

Wenn dieser Fehler auftritt, stellen Sie sicher, dass der brieftaschenordnerpfad, den Sie in sqlnet.ora angegeben haben, der vollständige und richtige Pfad zum Brieftaschenordner ist.

Konfigurieren des Gateways

1. Installieren und Einrichten eines lokalen Datengateways.

2. Wählen Sie im Power BI-Dienst das Zahnradsymbol oben rechts und dann " Gateways verwalten" aus.

   

3. Wählen Sie in "Datenquelle hinzufügen" die Option "Datenquellen hinzufügen" aus, um das Gateway zu verwenden.

   

4. Geben Sie unter "Datenquellenname" den Namen ein, den Sie als Datenquelleneinstellung verwenden möchten.

5. Wählen Sie in "Datenquellentyp" Oracle aus.

6. Geben Sie in Server den Net-Dienstnamen des Oracle Autonomous Database-Servers ein, mit dem eine Verbindung hergestellt werden soll.

7. Wählen Sie in der Authentifizierungsmethode " Einfach" aus.

8. Geben Sie den Benutzernamen und das Kennwort für die Oracle Autonomous Database ein. In diesem Beispiel werden der Standardbenutzername des Datenbankadministrators (ADMIN) und das Kennwort verwendet.

9. Wählen Sie Hinzufügen aus.

   

Wenn alles ordnungsgemäß installiert und konfiguriert wurde, wird eine Meldung "Verbindung erfolgreich " angezeigt. Sie können jetzt eine Verbindung mit der Oracle Autonomous Database herstellen, indem Sie die gleichen Schritte ausführen, die in "Herstellen einer Verbindung mit einer lokalen Oracle-Datenbank aus Power Query Online" beschrieben sind.

Verbinden mithilfe erweiterter Optionen

Power Query Desktop und Power Query Online bieten bei Bedarf eine Reihe erweiterter Optionen, die Sie Ihrer Abfrage hinzufügen können.

In der folgenden Tabelle sind alle erweiterten Optionen aufgeführt, die Sie in Power Query Desktop und Power Query Online festlegen können.

Erweiterte Option	BESCHREIBUNG
Befehlstimeout in Minuten	Wenn Ihre Verbindung länger als 10 Minuten dauert (Standard-Timeout), können Sie einen anderen Wert in Minuten eingeben, um die Verbindung länger offen zu halten. Diese Option ist nur in Power Query Desktop verfügbar.
SQL-Anweisung	Informationen hierzu erhalten Sie unter Importieren von Daten aus einer Datenbank mithilfe einer nativen Datenbankabfrage.
Beziehungsspalten einbeziehen	Wenn aktiviert, werden Spalten einbezogen, die möglicherweise Beziehungen zu anderen Tabellen haben. Wenn dieses Feld gelöscht wird, werden diese Spalten nicht angezeigt.
Navigieren mithilfe der vollständigen Hierarchie	Wenn diese Option aktiviert ist, zeigt der Navigator die vollständige Hierarchie von Tabellen in der Datenbank an, mit der Sie eine Verbindung herstellen. Wenn sie deaktiviert ist, werden im Navigator nur die Tabellen angezeigt, deren Spalten und Zeilen Daten enthalten.

Nachdem Sie die erweiterten Optionen ausgewählt haben, die Sie benötigen, wählen Sie "OK " in Power Query Desktop oder "Weiter " in Power Query Online aus, um eine Verbindung mit Ihrer Oracle-Datenbank herzustellen.

Verwenden des integrierten Oracle-Treibers (Vorschau)

Ab der April 2025-Version von Power BI Desktop und der Mai 2025-Version des lokalen Datengateways enthält der Oracle Connector einen integrierten Oracle Managed ODP.NET-Treiber für die Konnektivität. Dieses Feature entfernt die Notwendigkeit, dass Benutzer den Treiber installieren und verwalten müssen. Sie können dieses Feature aktivieren, indem Sie den nachstehenden Anweisungen folgen.

Um diesen integrierten Treiber in Power BI Desktop zu verwenden, navigieren Sie zu Optionen und Einstellungen (unter der Registerkarte Datei) >>, und aktivieren Sie dann das Kontrollkästchen, um die Option Verwendung des gebündelten Oracle Managed ODP Providers aktivieren zu aktivieren.

Um diesen integrierten Treiber im lokalen Datengateway zu verwenden, ändern Sie die Gatewaykonfigurationen, um mithilfe der folgenden Schritte die MashupFlight_EnableOracleBundledOdacProvider Einstellung zu aktualisieren.

1. Navigieren Sie auf dem lokalen Computer, auf dem das lokale Datengateway installiert ist, zu C:\Programme\Lokales Datengateway.
2. Erstellen Sie eine Sicherung der Konfigurationsdatei mit dem Namen Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
3. Öffnen Sie die ursprüngliche Konfigurationsdatei Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, und suchen Sie den Eintrag MashupFlight_EnableOracleBundledOdacProvider.
4. Aktualisieren Sie den MashupFlight_EnableOracleBundledOdacProvider Wert als True.
5. Starten Sie Das Gateway neu.

<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_EnableOracleBundledOdacProvider" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>    

Die verbleibenden Konfigurationen zum Herstellen einer Verbindung mit einer Oracle-Datenbank von Power Query Desktop sind identisch wie in den vorherigen Abschnitten beschrieben.

Bekannte Probleme und Einschränkungen

Power BI-Sitzungen können nach einer Aktualisierung des Semantikmodells für diese Oracle-Datenbank ungefähr noch 30 Minuten lang in Ihrer Oracle-Datenbank aktiv sein. Erst nach ungefähr 30 Minuten werden diese Sitzungen inaktiv/entfernt in der Oracle-Datenbank. Dieses Verhalten ist beabsichtigt.

Problembehandlung

Möglicherweise treten mehrere Fehler von Oracle auf, wenn die Benennungssyntax entweder falsch oder nicht ordnungsgemäß konfiguriert ist:

• ORA-12154: TNS: Der angegebene Verbindungsbezeichner konnte nicht aufgelöst werden.
• ORA-12514: TNS: Listener kennt derzeit den in der Verbindungsbeschreibung angeforderten Dienst nicht.
• ORA-12541: TNS: kein Listener.
• ORA-12170: TNS: Verbindungstimeout ist aufgetreten.
• ORA-12504: TNS: Listener erhielt nicht SERVICE_NAME in CONNECT_DATA.

Diese Fehler können auftreten, wenn der Oracle tnsnames.ora Database Connect-Deskriptor falsch konfiguriert ist, der bereitgestellte Net-Dienstname falsch geschrieben ist oder der Oracle-Datenbanklistener nicht ausgeführt wird oder nicht erreichbar ist, z. B. eine Firewall, die den Listener oder den Datenbankport blockiert. Stellen Sie sicher, dass Sie die Mindestinstallationsvoraussetzungen erfüllen. Weitere Informationen: Voraussetzungen

Besuchen Sie das Oracle Database Error Help Portal , um häufig auftretende Ursachen und Lösungen für den jeweiligen Oracle-Fehler zu überprüfen. Geben Sie Ihren Oracle-Fehler in der Portal-Suchleiste ein.

Wenn Sie Power BI Desktop aus dem Microsoft Store heruntergeladen haben, können Sie aufgrund eines Oracle-Treiberproblems möglicherweise keine Verbindung mit Oracle-Datenbanken herstellen. Wenn Dieses Problem auftritt, lautet die zurückgegebene Fehlermeldung: Objektverweis nicht festgelegt. Gehen Sie wie folgt vor, um das Problem zu beheben:

• Laden Sie Power BI Desktop aus dem Download Center anstelle des Microsoft Store herunter.

Wenn die Fehlermeldung " Objektverweis nicht festgelegt " in Power BI auftritt, wenn Sie eine Verbindung mit einer Oracle-Datenbank mithilfe des lokalen Datengateways herstellen, befolgen Sie die Anweisungen unter Verwalten Ihrer Datenquelle – Oracle.

Wenn Sie Power BI Report Server verwenden, lesen Sie die Anleitung im Artikel Oracle-Verbindungstyp.

Nächste Schritte

Optimieren von Power Query beim Erweitern von Tabellenspalten