Oracle Database

Zusammenfassung

Eigenschaft	Wert
Konnektor	Oracle-Datenbank
Produkte	Excel Power BI (Semantikmodelle) Power Query Online
Freigabestatus	Allgemeine Verfügbarkeit
Authentifizierungstypen	Windows (Desktop/Online) Datenbank (Desktop) Basic (online) Microsoft-Konto (Desktop)
Datenquellentyp	Oracle
Funktionsreferenzdokumentation	Oracle.Database

Voraussetzungen

Unterstützte Oracle-Versionen:

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

Ab der Version vom April 2025 von Desktop und der Version vom Mai 2025 des lokalen Datengateways können Sie den integrierten verwalteten ODP.NET-Treiber für Power BI Oracle verwenden, um eine Verbindung mit der Oracle-Datenbank herzustellen. Wenn Sie dieses Feature aktivieren, müssen Sie das OCMT nicht manuell installieren. Ab Juni 2026 können Sie auch eine Cloudverbindung mit Oracle Autonomous Database oder anderen Oracle Cloud-Endpunkten ohne Gateway erstellen. Erfahren Sie mehr über diese Funktion.

Wenn Sie den neuen integrierten Oracle-Treiber nicht verwenden, müssen Sie ein lokales Unternehmensdatengateway verwenden und den 64-Bit-Oracle-Client für Microsoft Tools (OCMT) auf dem Computer installieren, auf dem das Gateway oder Power BI desktop ausgeführt wird. Weitere Informationen finden Sie unter Verwalten der Datenquelle – Oracle.

Unterstützte Funktionen

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

Herstellen einer Verbindung über Power Query Desktop

Lokale Datenbank

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 über Power BI Desktop eine Verbindung herstellen, wählen Sie entweder den Import- oder DirectQuery-Datenkonnektivitätsmodus 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.

Verbindung mit Power Query Online herstellen

Lokale Datenbank

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.

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.

Zusatzinformation

Verwenden der Option Oracle Client für Microsoft-Tools (OCMT)

Oracle Client für Microsoft Tools installiert und konfiguriert Oracle Datenanbieter 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 Service, 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 64-Bit-Desktop und -Dienst 64-Bit-OCMT. Verwenden Sie für 32-Bit Power BI Desktop 32-Bit-OCMT.

Auch wenn Sie bereits einen Oracle Client oder ODP.NET auf Ihrem Power BI Client installiert haben, empfehlen wir Ihnen dringend, das OCMT-Installationsprogramm zu verwenden, um alle Konfigurationsschritte ordnungsgemäß abzuschließen, die Power BI benötigt, um mit der Oracle-Datenbank zu arbeiten.

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

Herstellen einer Verbindung mit einer Oracle Autonomous Database

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 BIDesktop (Desktop abrufenPower BI) oder Power BI Dienstkonto (Lizenzieren des Power BI Diensts für Benutzer in Ihrer Organisation)

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.

Power BI Desktop mit Oracle ADB verbinden

1. Power BI Desktop öffnen.

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 aus 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 treten auch mehrere Fehler auf, da die Konfiguration nicht ordnungsgemäß eingerichtet ist. 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.

Erweiterte 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.

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 Sie Microsoft Entra ID Single Sign-On für Oracle-Cloudverbindungen

Der Power BI Dienst unterstützt Microsoft Entra ID Einmaliges Anmelden (Single Sign-On, SSO) für direkte Cloudverbindungen mit Oracle-Datenbanken.

Um Cloud-SSO zu verwenden, muss ein Fabric-Administrator die Mandanteneinstellung „Oracle SSO aktivieren“ im Verwaltungsportal aktivieren. Konfigurieren Sie Ihre Oracle-Umgebung so, dass Microsoft Entra ID Token akzeptiert werden. Weitere Informationen finden Sie unter Verwenden von Microsoft Entra ID mit Oracle.

Verwenden des integrierten Oracle-Treibers

Für den Importmodus in Power BI Desktop

Für die Juni 2026-Version des Power BI Desktop- oder lokalen Datengateways wird standardmäßig ein integrierter Oracle Managed ODP.NET-Treiber für die Konnektivität verwendet. Dieses Feature entfernt die Notwendigkeit, dass Benutzer den Treiber installieren und verwalten müssen. Sie können dieses Feature weiterhin deaktivieren, indem Sie die folgenden Anweisungen verwenden.

Wenn Sie diesen integrierten Treiber nicht in Power BI Desktop verwenden möchten, wechseln Sie zu Optionen und Einstellungen (unter der Registerkarte Datei) Optionen>>, und deaktivieren Sie dann das Kontrollkästchen für die Option Verwendung des gebündelten Oracle Managed ODP Providers für den Importmodus aktivieren.

Für den DirectQuery-Modus in Power BI Desktop (Vorschau)

Für den DirectQuery-Modus befindet sich der integrierte verwaltete ODP-Treiber von Oracle.NET noch in der Vorschau. Verwenden Sie zum Anmelden die folgenden Anweisungen.

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

Für den Importmodus mit lokalem Gateway

Ab der Version vom Juni 2026 verwendet das lokale Datengateway standardmäßig den in Oracle verwalteten ODP.NET Treiber für die Konnektivität. Wenn Sie diesen integrierten Treiber nicht im lokalen Datengateway für den Importmodus verwenden möchten, ändern Sie die Gatewaykonfigurationen, um die MashupFlight_DisableOracleBundledOdacProviderV2 Einstellung mithilfe der folgenden Schritte 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_DisableOracleBundledOdacProviderV2.
4. Aktualisieren Sie den MashupFlight_DisableOracleBundledOdacProviderV2 Wert auf True.
5. Starten Sie Das Gateway neu.

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

Für den DirectQuery-Modus im lokalen Gateway (Vorschau)

Das lokale Datengateway kann für DirectQuery den integrierten Oracle Managed ODP.NET-Treiber verwenden. Diese Funktion befindet sich in der Vorschauversion.

FetchSize zur Leistungsoptimierung konfigurieren

Der integrierte Oracle-Treiber verwendet die folgenden Standardwerte FetchSize :

Für das Gateway DirectQuery ist für die Gatewayversion vom November 2026 geplant, die Standardeinstellung FetchSize auf 8 MB zu erhöhen und dieselbe ODAC.config-Konfiguration wie im Importmodus zu unterstützen.

Ab der Gatewayversion vom Oktober 2026 können Sie FetchSize für den Importmodus in ODAC.config konfigurieren. Die Datei befindet sich im ADO.NET Providers Unterordner des Gatewayinstallationsordners.

So konfigurieren Sie FetchSize:

1. Erstellen Sie eine Sicherungskopie von ODAC.config, und öffnen Sie die Datei dann in einem Text-Editor.

2. Fügen Sie den FetchSize-Eintrag hinzu oder aktualisieren Sie den FetchSize-Eintrag unter >oracle.manageddataaccess.clientversion>settings. Geben Sie den Wert in Byte an. Im folgenden Beispiel wird FetchSize auf 16.777.216 Bytes (16 MB) festgelegt:

   <configuration>
     <oracle.manageddataaccess.client>
       <version number="*">
         <settings>
           <setting name="FetchSize" value="16777216" />
         </settings>
       </version>
     </oracle.manageddataaccess.client>
   </configuration>
   

   Fügen Sie die Einstellung in Ihre vorhandene Konfiguration ein. Behalten Sie andere Einstellungen bei, wie TNS_ADMIN.

3. Speichern Sie ODAC.config, und starten Sie dann den lokalen Datengatewaydienst neu.

Gateway-Upgrades überschreiben ODAC.config. Bewahren Sie eine Kopie Ihrer Konfigurationsänderungen auf, damit Sie sie nach einem Upgrade erneut anwenden können.

Unterstützte Methoden zum Angeben von TNS_ADMIN mit dem integrierten Oracle-Treiber

Es gibt drei Optionen zum Angeben von TNS_ADMIN:

• Konfigurieren Sie TNS_ADMIN in OADC.config
• Verwenden einer Umgebungsvariable
• Verwenden von Einstellungen aus einem zuvor installierten OADC

Konfigurieren von TNS_ADMIN in ODAC.config

Wenn Sie den integrierten Oracle-Treiber verwenden und Zugriff auf die Änderung von Programmdateien haben, können Sie TNS_ADMIN in der Konfigurationsdatei angeben, die in der Datei ODAC.config vom integrierten Oracle-Treiber verwendet wird. Die Datei befindet sich auf dem Power BI Desktop oder am Installationsort des lokalen Datengateways im Unterordner „ADO.NET Providers“. Im Folgenden finden Sie ein Beispiel für die Angabe des TNS_ADMIN-Pfads "C:\network\admin".

Dieser Konfigurationswert hat Vorrang vor anderen Optionen.

Beispielkonfiguration

<configuration>
 ...
 <oracle.manageddataaccess.client>
  <version number="*">
   <settings>
    <setting name="TNS_ADMIN" value="C:\network\admin" />
   </settings>
  </version>
 </oracle.manageddataaccess.client>
 ...
</configuration>

Beachten Sie, dass das in der ODAC.config konfigurierte TNS_ADMIN Vorrang vor einer TNS_ADMIN-Einstellung in der Umgebung erhält.

Eine Umgebungsvariable verwenden

Wenn der Benutzer keinen Zugriff zum Ändern ODAC.confighat, kann er TNS_ADMIN angeben, indem er eine TNS_ADMIN Umgebungsvariable hinzufügt. Die Umgebungsvariable kann eine Systemumgebungsvariable oder eine Benutzerumgebungsvariable für den Benutzer sein, der Power BI Desktop oder das On-premises Data Gateway ausführt. Legen Sie den TNS_ADMIN Wert beispielsweise auf "C:\network\admin" fest.

Das Festlegen von TNS_ADMIN in der Umgebung (insbesondere auf Systemebene) kann dazu führen, dass andere Anwendungen, die auf diesem Computer ausgeführt werden, die Netzwerkkonfigurationsdateien (z. B. tnsnames.ora) vom Speicherort, auf den TNS_ADMIN verweist, übernehmen.

Verwenden von Einstellungen aus einem zuvor installierten ODAC

Wenn ODAC zuvor installiert ist und TNS_ADMIN konfiguriert ist, erkennt Power BI TNS_ADMIN automatisch.

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

Liste der zulässigen Eigenschaften

Benutzer können Oracle-Servernamen unter Verwendung von Verbindungsdeskriptoren wie (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name))) angeben. Das System erzwingt, welche Eigenschaften in Desktop und Gateway verwendet werden können. Die zulässigen Standardeigenschaften ODAC.config sind im folgenden Abschnitt aufgeführt.

<configuration>
 ...
  <AllowLists>
    <!--
      Oracle connection strings can contain connection properties, for example  CONNECT_TIMEOUT.   Only connection properties explicitly set to true in the list below will
      be allowed with Power BI Desktop and the On Premises Data Gateway. Using our example, you can add "CONNECT_TIMEOUT":true to the list to enable it. To disable it you
      can remove it from the list, or set the value to false. This list will be enforced on all connection string types including connect descriptors and aliases
      referencing a tnsnames.ora entry. The use of any disallowed property in a connection string will result in an ORA-50122 error. Restart Power BI Desktop or the On-premises
      Data Gateway service after applying ODAC.config changes.
      For more information see https://docs.oracle.com/en/database/oracle/oracle-database/26/odpnt/InstallConnectionConfigurationRestriction.html
    -->
    <OnPremAllowList>{"DataSource":{"HOST":true,"PORT":true,"PROTOCOL":true,"HTTPS_PROXY":true,"HTTPS_PROXY_PORT":true,"ENABLE":true,"EXPIRE_TIME":true,"FAILOVER":true,"LOAD_BALANCE":true,"RECV_BUF_SIZE":true,"SDU":true,"SEND_BUF_SIZE":true,"SOURCE_ROUTE":true,"TYPE_OF_SERVICE":true,"COLOCATION_TAG":true,"CONNECTION_ID_PREFIX":true,"FAILOVER_MODE":true,"GLOBAL_NAME":true,"HS":true,"INSTANCE_NAME":true,"POOL_BOUNDARY":true,"POOL_CONNECTION_CLASS":true,"POOL_NAME":true,"POOL_PURITY":true,"RDB_DATABASE":true,"SHARDING_KEY":true,"SHARDING_KEY_ID":true,"SUPER_SHARDING_KEY":true,"SERVER":true,"SERVICE_NAME":true,"SID":true,"TUNNEL_SERVICE_NAME":true,"SSL_CLIENT_AUTHENTICATION":true,"SSL_CERTIFICATE_ALIAS":true,"SSL_CERTIFICATE_THUMBPRINT":true,"SSL_VERSION":true,"SSL_SERVER_DN_MATCH":true,"SSL_SERVER_CERT_DN":true,"WALLET_LOCATION":true,"CONNECT_TIMEOUT":true,"RETRY_COUNT":true,"RETRY_DELAY":true,"TRANSPORT_CONNECT_TIMEOUT":true,"RECV_TIMEOUT":true,"COMPRESSION":true,"COMPRESSION_LEVELS":true,"USE_SNI":true,"AUTHENTICATION_SERVICE":true,"IGNORE_ANO_ENCRYPTION_FOR_TCPS":true,"OCI_CONFIG_FILE":true,"OCI_DATABASE":true,"OCI_IAM_URL":true,"OCI_PROFILE":true,"OCI_TENANCY":true,"PASSWORD_AUTH":true,"REDIRECT_URI":true,"TENANT_ID":true,"TLS_VERSION":true,"TOKEN_AUTH":true,"TOKEN_LOCATION":true}}
    </OnPremAllowList>
  </AllowLists>
 ...
</configuration>

Benutzer können diese liste zulässiger Eigenschaften ändern, wenn sie neue Eigenschaften hinzufügen oder Eigenschaften aus der Liste entfernen müssen, um strengere Regeln zu erzwingen.

Einschränkungen und Überlegungen

Power BI Sitzungen können nach einer Aktualisierung des Semantikmodells für diese Oracle-Datenbank ungefähr 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: could not resolve the connect identifier specified.
• ORA-12514: TNS: listener does not currently know of service requested in connect descriptor.
• ORA-12541: TNS: no listener.
• ORA-12170: TNS: connect timeout occurred.
• ORA-12504: TNS: listener was not given the 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. Um das Problem zu beheben, laden Sie Power BI Desktop aus dem Download Center anstelle von Microsoft Store herunter.

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

Wenn Sie Power BI Report Server verwenden, lesen Sie die Hinweise im Artikel Oracle Connection Type.

Bekannte Probleme mit dem integrierten Oracle-Treiber

Die folgenden bekannten Probleme sind spezifisch für den integrierten oracle managed ODP.NET Treiber. Konfigurationsoptionen finden Sie unter Verwenden des integrierten Oracle-Treibers.

TNS-Aliase in einer Netzwerkfreigabe werden nicht aufgelöst

Gilt für das lokale Datengateway, sowohl im Import als auch in DirectQuery.

Wenn Ihre Oracle-Netzwerkkonfigurationsdateien (tnsnames.ora oder das TNS_ADMIN-Verzeichnis) auf einer Netzwerkfreigabe (UNC-Pfad) gespeichert sind, kann der integrierte Treiber den Net-Service-Namen (TNS-Alias) durchgängig nicht auflösen. Möglicherweise sehen Sie ORA-12154: TNS:could not resolve the connect identifier specified oder ORA-50201: Failed to connect to server. Derselbe Alias wird mit dem nicht verwalteten ODP.NET-Treiber korrekt aufgelöst oder wenn sich die Dateien in einem lokalen Pfad befinden. Der integrierte verwaltete Treiber liest oracle-Netzwerkkonfigurationsdateien nicht zuverlässig von einem UNC-Speicherort aus.

Verwenden Sie eine der folgenden Problemumgehungen:

• Kopieren Sie tnsnames.ora (und sqlnet.ora wenn Sie ihn verwenden) in einen Ordner auf einem lokalen Laufwerk, und zeigen Sie dann den Treiber auf diesen Ordner. Siehe Unterstützte Möglichkeiten zum Angeben von TNS_ADMIN mit dem integrierten Oracle-Treiber. Für Gateway DirectQuery legen Sie TNS_ADMIN im Systembereich (Computer) fest, da das Gateway-Dienstkonto keine benutzerbezogenen Variablen lesen kann, und starten Sie dann den Gatewaydienst neu.
• Stellen Sie sicher, dass das Dienstkonto, unter dem das Gateway ausgeführt wird, Zugriff auf die Netzwerkfreigabe hat.
• Geben Sie einen Easy Connect-Deskriptor direkt in Server ein (z. B. host:port/service_name) statt eines tnsnames.ora-Alias, sodass keine Netzwerkkonfigurationsdatei erforderlich ist.
• Deaktivieren Sie den integrierten Treiber, um auf den unverwalteten ODP.NET-Treiber zurückzugreifen, der die Dateien von der Freigabe lesen kann.

NLS_LANG wird ignoriert.

Gilt für Power BI Desktop, das lokale Datengateway und Power BI Cloudverbindungen des Diensts, sowohl im Import als auch in DirectQuery.

Mit dem integrierten Treiber richten sich die Oracle-Sitzungssprache, das Gebietsschema sowie Zahlen- und Datumsformate nach der .NET-Kultur des Computers (den regionalen Einstellungen und Formateinstellungen von Windows) und nicht nach der Umgebungsvariable NLS_LANG. Das Festlegen oder Ändern NLS_LANG hat keine Auswirkung. Je nach Region des Computers kann dieses Verhalten dazu führen, dass Zahlen oder Datumsangaben mit den falschen Trennzeichen oder der Datumsreihenfolge analysiert werden, Abfragen null Zeilen oder falsche Werte zurückgeben oder Fehler wie ORA-01722, , ORA-01858, , ORA-01861oder ORA-01843. Beispielsweise kann ein bericht, der auf einem Computer erstellt wurde, der auf Englisch (USA) festgelegt ist, null Zeilen oder Fehler auf einem Computer zurückgeben, der auf Englisch (Vereinigtes Königreich) festgelegt ist. Der verwaltete ODP.NET-Treiber leitet seine National Language Support (NLS)-Einstellungen aus der Kultur des .NET-Threads statt aus NLS_LANG ab, im Gegensatz zum nicht verwalteten ODP.NET-Treiber, der NLS_LANG berücksichtigt.

Verwenden Sie eine der folgenden Problemumgehungen:

• Stimmen Sie die regionalen Einstellungen des Computers mit dem Gebietsschema überein, für das Ihre Daten und Abfragen entwickelt wurden.
• Deaktivieren Sie den integrierten Treiber, um auf den nicht verwalteten ODP.NET-Treiber zurückzugreifen, der NLS_LANG berücksichtigt.

Hintergrundinformationen zum Globalisierungsverhalten des verwalteten Treibers finden Sie in der Dokumentation zur Unterstützung der Globalisierung von Oracle.

Verwandte Inhalte

Optimieren von Power Query beim Erweitern von Tabellenspalten