Oracle-database

Samenvatting

Onderdeel	Beschrijving
Status van vrijgave	Algemene beschikbaarheid
Producten	Excel Power BI (Semantische modellen) Power BI (gegevensstromen) Fabric (Gegevensstroom Gen2) Power Apps (gegevensstromen) Dynamics 365 Customer Insights Analyse diensten
Ondersteunde verificatietypen	Windows (bureaublad/online) Database (bureaublad) Basis (online) Microsoft-account (desktop)
Documentatie voor functiereferenties	Oracle.Database

Opmerking

Sommige mogelijkheden zijn mogelijk aanwezig in één product, maar niet in andere vanwege implementatieschema's en hostspecifieke mogelijkheden.

Vereiste voorwaarden

Ondersteunde Oracle-versies:

• Oracle Database Server 12c (12.1.0.2) en hoger
• Oracle Autonomous Database - alle versies

Vanaf de versie van april 2025 van Power BI Desktop en de on-premises gegevensgateway van mei 2025 kunt u het ingebouwde door Oracle beheerde ODP.NET-stuurprogramma gebruiken om verbinding te maken met de Oracle-database. Wanneer u deze functie inschakelt, hoeft u de OCMT niet handmatig te installeren. Vanaf juni 2026 kunt u ook een cloudverbinding maken met Oracle Autonomous Database of andere Oracle-cloudeindpunten zonder gateway. Meer informatie over deze functie .

Als u het nieuwe ingebouwde Oracle-stuurprogramma niet gebruikt, moet u een on-premises gegevensgateway voor ondernemingen gebruiken en de 64-bits Oracle-client voor Microsoft Tools (OCMT) installeren op de computer waarop de gateway of Power BI Desktop wordt uitgevoerd. Zie Uw gegevensbron beheren - Oracle voor meer informatie.

Ondersteunde mogelijkheden

• Importeren
• DirectQuery (semantische Power BI-modellen)
• Geavanceerde opties
  • Time-out van opdracht in minuten
  • SQL-opdracht
  • Relatiekolommen opnemen
  • Navigeren met volledige hiërarchie

De optie Oracle Client voor Microsoft Tools (OCMT) gebruiken

Oracle Client voor Microsoft Tools installeert en configureert Oracle Data Provider voor .NET (ODP.NET) ter ondersteuning van 32-bits en 64-bits Microsoft-hulpprogrammaverbindingen met Oracle on-premises en clouddatabases, waaronder Oracle Autonomous Database (ADB). OCMT is een grafisch installatieprogramma waarmee het installatieproces van de Oracle Database-client wordt geautomatiseerd. Het biedt ondersteuning voor verbinding met 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 en BizTalk Server.

OCMT is gratis software. Deze kan worden gedownload vanaf de pagina Oracle Client voor Microsoft Tools. Voor 64-bit Power BI Desktop en Power BI-service gebruikt u 64-bit OCMT. Voor 32-bits Power BI Desktop gebruikt u 32-bits OCMT.

Zelfs als u al een Oracle-client of ODP.NET op uw Power BI-client hebt geïnstalleerd, raden we u ten zeerste aan het OCMT-installatieprogramma te gebruiken om alle configuratiestappen die Power BI nodig heeft om met de Oracle-database te werken.

• OCMT 64-bits en 32-bits downloads
• Installatie- en installatie-instructies voor OCMT

Verbinding maken met een on-premises Oracle-database vanuit Power BI Desktop

Voer de volgende stappen uit om de verbinding te maken:

1. Selecteer de Oracle-databaseoptie in de connectorselectie.

2. Geef de Oracle net-servicenaam/TNS-alias of Easy Connect-verbindingsreeks (Plus) op waarmee verbinding moet worden gemaakt in Server. Easy Connect is het eenvoudigst te gebruiken door de serverwaarde in te stellen op de Hostnaam/ServiceName van uw Oracle Database-server, waarbij ServiceName de globale databasenaam is. In de volgende schermopname wordt een netservicenaam gebruikt.

   

3. Als u verbinding maakt vanuit Power BI Desktop, selecteert u de modus Importeren of DirectQuery-gegevensconnectiviteit . In de rest van deze voorbeeldstappen wordt de modus Gegevensconnectiviteit importeren gebruikt. Ga naar DirectQuery gebruiken in Power BI Desktop voor meer informatie over DirectQuery.

4. Als u voor het eerst verbinding maakt met deze Oracle-database, selecteert u het verificatietype dat u wilt gebruiken en voert u vervolgens uw referenties in. De beschikbare verificatietypen zijn:

   • Windows (Windows-verificatie)
   • Database (gebruikersnaam en wachtwoord)
   • Microsoft-account (Microsoft Entra-id)

   Ga naar Verificatie met een gegevensbron voor meer informatie over verificatie.

   

5. Selecteer in Navigator de gegevens die u nodig hebt en selecteer vervolgens Laden om de gegevens te laden of Gegevens transformeren om de gegevens te transformeren.

Verbinding maken met een on-premises Oracle-database vanuit Power Query Online

Voer de volgende stappen uit om de verbinding te maken:

1. Een op locatie gegevensgateway installeren en instellen.

2. Selecteer in Power Query Online de oracle-databaseoptie in de selectie van gegevensbronnen.

3. Geef in het weergegeven Oracle-database dialoogvenster de Oracle Net-servicenaam/TNS-alias, de Easy Connect Plus-verbindingsreeks, of de verbinddescriptor op waarmee verbinding moet worden gemaakt in Server.

   

4. Geef een verbindingsnaam op, zoals testoracleserver.

5. Kies de naam van uw lokale gegevensgateway.

6. Als u voor het eerst verbinding maakt met deze Oracle-database, selecteert u het type referenties voor de verbinding in verificatietype. Kies Basic als u zich wilt aanmelden met een Oracle-gebruikersnaam en -wachtwoord. Kies Windows bij het gebruik van Windows-besturingssysteemverificatie en met zowel de Oracle-client als de server die wordt uitgevoerd in Windows.

7. Voer uw referenties in.

8. Selecteer Volgende om door te gaan.

9. Selecteer in Navigator de gegevens die u nodig hebt en selecteer vervolgens Gegevens transformeren om de gegevens te transformeren in de Power Query-editor.

Verbinding maken met een autonome Oracle-database

Opmerking

Op dit moment kunt u verbinding maken met een Oracle Autonomous Database vanuit Excel, Power BI Desktop, Power BI-service, Fabric (Dataflow Gen2), Power Apps, SQL Server Analysis Services en BizTalk Server met behulp van de procedures in deze sectie. Deze hulpprogramma's maken gebruik van onbeheerde ODP.NET om verbinding te maken. Andere Microsoft-hulpprogramma's, waaronder SQL Server Data Tools, SQL Server Integration Services en SQL Server Reporting Services, gebruiken beheerde ODP.NET om verbinding te maken met Oracle Autonomous Database met behulp van grotendeels vergelijkbare procedures.

Als u Power BI wilt verbinden met een Oracle Autonomous Database, hebt u de volgende accounts en apps nodig:

• Een Oracle.com-account (Oracle.com-accountregistratie)
• Een Oracle Cloud-account (aanmelding voor Oracle Cloud-account)
• Een Autonome Oracle-database (een altijd gratis autonome database ophalen)
• Power BI Desktop (Power BI Desktop ophalen) of Power BI-serviceaccount (licentieverlening voor de Power BI-service voor gebruikers in uw organisatie)

Uw clientreferenties downloaden

De eerste stap bij het instellen van een verbinding met de Autonome Oracle-database is het downloaden van uw clientreferenties.

Om uw klantinloggegevens te downloaden:

1. Selecteer db-verbinding op de pagina met gegevens van de autonome Oracle-database.

   

2. Selecteer Wallet downloaden op de pagina Databaseverbinding.

   

3. Voer een wachtwoord in dat u met deze portemonnee wilt gebruiken, bevestig het wachtwoord en selecteer Vervolgens Downloaden.

   

Oracle ADB-referenties configureren

1. Ga op uw Windows-computer naar de map waarin u uw Oracle ADB-referenties hebt gedownload van Uw clientreferenties downloaden.

2. Pak de inloggegevens uit in de map die u hebt opgegeven in OCMT als de Oracle Configuration File Directory. In dit voorbeeld worden de gegevens geëxtraheerd naar c:\data\wallet\wallet_contosomart.

   

   Opmerking

   Het bestand tnsnames.ora definieert het adres en de verbindingsgegevens van uw Oracle Autonomous Database.

3. Open sqlnet.ora in een editor, zoals Kladblok.

4. Wijzig onder WALLET_LOCATION het pad naar uw portemonneemap onder de optie Map. In dit voorbeeld:

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

5. Sla het bestand sqlnet.ora op en sluit het.

Open het bestand tnsnames.ora in de map wallets. Het bestand bevat een lijst met ADB-netservicenamen waarmee u verbinding kunt maken. In dit voorbeeld zijn de namen contosomart_high, contosomart_low en contosomart_medium. De namen van uw ADB-netservice verschillen.

Power BI Desktop verbinden met Oracle ADB

1. Open Power BI Desktop.

2. Selecteer Gegevens ophalen.

3. Vanuit Gegevens ophalen selecteer Database>Oracle-database.

4. Voer de netservicenaam in van de Oracle Autonomous Database-server waarmee u verbinding wilt maken. In dit voorbeeld is de server contosomart_high. Selecteer vervolgens OK.

   

5. Als u zich voor de eerste keer aanmeldt bij deze server vanuit Power BI Desktop, wordt u gevraagd uw referenties in te voeren. Selecteer Database en voer vervolgens de gebruikersnaam en het wachtwoord voor de Oracle-database in. De referenties die u hier invoert, zijn de gebruikersnaam en het wachtwoord voor de specifieke Oracle Autonomous Database waarmee u verbinding wilt maken. In dit voorbeeld worden de initiële gebruikersnaam en het wachtwoord van de database gebruikt. Klik op Verbinden.

   

   Opmerking

   U kunt Microsoft Entra ID-verificatie gebruiken om u aan te melden bij Oracle Autonomous Database via de microsoft-accountoptie .

Op dit moment wordt de Navigator weergegeven en worden de verbindingsgegevens getoond.

U kunt ook een van de verschillende fouten tegenkomen omdat de configuratie niet goed is ingesteld. Deze fouten worden besproken in Probleemoplossing.

Een fout die zich in deze eerste test kan voordoen, vindt plaats in Navigator, waar de database lijkt te zijn verbonden, maar geen gegevens bevat. In plaats daarvan wordt een Oracle: ORA-28759: fout bij het openen van het bestand weergegeven in plaats van de gegevens.

Als deze fout optreedt, moet u ervoor zorgen dat het pad naar de wallet-map die u hebt opgegeven in sqlnet.ora het volledige en juiste pad naar de wallet-map is.

Verbinding maken met behulp van geavanceerde opties

Power Query Desktop en Power Query Online bieden een set geavanceerde opties die u indien nodig aan uw query kunt toevoegen.

De volgende tabel bevat alle geavanceerde opties die u kunt instellen in Power Query Desktop en Power Query Online.

Geavanceerde optie	Beschrijving
Time-out van opdracht in minuten	Als uw verbinding langer duurt dan tien minuten (de standaardtime-out), kunt u in minuten een andere waarde invoeren om de verbinding langer open te houden. Deze optie is alleen beschikbaar in Power Query Desktop.
SQL-opdracht	Ga voor informatie naar Gegevens importeren uit een database met behulp van een systeemeigen databasequery.
Relatiekolommen opnemen	Indien aangevinkt, bevat het kolommen die mogelijk relaties hebben met andere tabellen. Als dit vak is uitgeschakeld, worden deze kolommen niet weergegeven.
Navigeren met volledige hiërarchie	Als dit is ingeschakeld, geeft de navigator de volledige hiërarchie weer van tabellen in de database waarmee u verbinding maakt. Als dit leeggemaakt is, geeft de navigator alleen de tabellen weer waarvan de kolommen en rijen gegevens bevatten.

Zodra u de geavanceerde opties hebt geselecteerd die u nodig hebt, selecteert u OK in Power Query Desktop of Volgende in Power Query Online om verbinding te maken met uw Oracle-database.

Het ingebouwde Oracle-stuurprogramma gebruiken

Voor de importmodus in Power BI Desktop

Voor de versie van juni 2026 van Power BI Desktop of on-premises gegevensgateway is standaard het gebruik van een ingebouwd door Oracle beheerde ODP.NET-stuurprogramma voor connectiviteit. Deze functie verwijdert de noodzaak voor gebruikers om het stuurprogramma te installeren en te beheren. U kunt deze functie nog steeds afmelden met behulp van de volgende instructies.

Als u dit ingebouwde stuurprogramma niet wilt gebruiken in Power BI Desktop, gaat u naar opties en instellingen (op het tabblad Bestand) >Opties>preview-functies en schakelt u het selectievakje uit om de optie Inschakelen met behulp van gebundelde Oracle Managed ODP-provider voor importmodus in te schakelen.

Voor de DirectQuery-modus in Power BI Desktop (Preview)

Voor de DirectQuery-modus is het gebruik van het ingebouwde door Oracle beheerde ODP.NET stuurprogramma nog in preview. Als u zich wilt aanmelden, gebruikt u de volgende instructies.

Als u dit ingebouwde stuurprogramma in Power BI Desktop wilt gebruiken, gaat u naar opties en instellingen (op het tabblad Bestand) >Opties>preview-functies en schakelt u het selectievakje uit om de optie Inschakelen met behulp van gebundelde Oracle Managed ODP-provider voor DirectQuery-modus in te schakelen.

Voor de importmodus in een on-premises gateway

Vanaf de versie van juni 2026 gebruikt de on-premises gegevensgateway standaard het ingebouwde door Oracle beheerde ODP.NET-stuurprogramma voor connectiviteit. Als u dit ingebouwde stuurprogramma niet wilt gebruiken in de on-premises gegevensgateway voor de importmodus, wijzigt u de gatewayconfiguraties om de MashupFlight_DisableOracleBundledOdacProviderV2 instelling bij te werken met behulp van de volgende stappen:

1. Navigeer op de lokale computer waarop de on-premises gegevensgateway is geïnstalleerd naar C:\Program Files\On-premises gegevensgateway.
2. Maak een back-up van het configuratiebestand met de naam Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
3. Open het oorspronkelijke Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config configuratiebestand en zoek de MashupFlight_DisableOracleBundledOdacProviderV2 vermelding.
4. Werk de MashupFlight_DisableOracleBundledOdacProviderV2 waarde bij naar True.
5. Start de gateway opnieuw op.

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

Opmerking

Zodra u de MashupFlight_DisableOracleBundledOdacProviderV2 instelling in het Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config-bestand hebt gewijzigd, blijft de configuratie behouden via upgrades van de on-premises gegevensgateway.

Opmerking

Als uw semantische modellen nog steeds een persoonlijke gateway gebruiken om verbinding te maken met on-premises Oracle-gegevensbronnen, voert u een upgrade uit naar een on-premises gegevensgateway of virtuele netwerkgateway (VNET) van een onderneming of verschuift u uw Oracle-workloads naar directe cloudverbindingen. De bijgewerkte Oracle-connector biedt geen ondersteuning voor persoonlijke on-premises gegevensgateways. Dit geldt zowel voor de importmodus als de DirectQuery-modus. Bestaande semantische modellen kunnen een persoonlijke gateway blijven gebruiken totdat u de gegevensverbindingsbinding bijwerkt. Nadat u de binding hebt bijgewerkt, kunt u niet teruggaan naar de persoonlijke gateway. Plan uw Oracle-verbindingsupgrades dienovereenkomstig.

Voor de DirectQuery-modus in de on-premises gateway (preview)

De on-premises gegevensgateway kan gebruikmaken van het ingebouwde door Oracle beheerde ODP.NET-stuurprogramma voor DirectQuery. Deze functie is beschikbaar als preview-versie.

Als u een TNS-alias voor DirectQuery wilt oplossen, gebruikt u een omgevingsvariabele. Het serviceaccount van de gateway heeft geen toegang tot variabelen met gebruikersbereik, dus stel TNS_ADMIN in op systeemniveau (computer) en start vervolgens de service voor de on-premises gegevensgateway opnieuw.

Het ingebouwde stuurprogramma biedt geen ondersteuning voor verificatie van Oracle-proxygebruikers. Zie voor meer informatie en tijdelijke oplossingen de verificatie van Oracle-proxygebruikers wordt niet ondersteund.

Ondersteunde manieren om TNS_ADMIN op te geven met het ingebouwde Oracle-stuurprogramma

Er zijn drie opties om TNS_ADMIN op te geven:

• De TNS_ADMIN configureren in OADC.config
• Een omgevingsvariabele gebruiken
• Instellingen van een eerder geïnstalleerde OADC gebruiken

TNS_ADMIN configureren in ODAC.config

Als u het ingebouwde Oracle-stuurprogramma gebruikt en toegang hebt om programmabestanden te wijzigen, kunt u TNS_ADMIN opgeven in het configuratiebestand ODAC.config gebruikt door ingebouwd Oracle-stuurprogramma. Het bestand bevindt zich in Power BI Desktop en/of op de on-premises locatie waar de gegevensgateway is geïnstalleerd, onder de submap genaamd 'ADO.NET Providers'. Hier volgt een voorbeeld van het opgeven van TNS_ADMIN pad dat 'C:\network\admin' is.

Deze configuratiewaarde heeft voorrang op andere opties.

Voorbeeldconfiguratie

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

Houd er rekening mee dat TNS_ADMIN geconfigureerd in de ODAC.config voorrang heeft op een TNS_ADMIN instelling in de omgeving.

Een omgevingsvariabele gebruiken

Als de gebruiker geen toegang heeft om ODAC.configte wijzigen, kunnen ze TNS_ADMIN opgeven door een TNS_ADMIN omgevingsvariabele toe te voegen. De omgevingsvariabele kan een systeemomgevingsvariabele of een gebruikersomgevingsvariabele zijn voor de gebruiker met Power BI Desktop of de on-premises gegevensgateway. Stel de TNS_ADMIN-waarde in op 'C:\network\admin', bijvoorbeeld.

Als u TNS_ADMIN instelt in de omgeving (met name op systeemniveau), kunnen andere toepassingen die op deze computer worden uitgevoerd, de netwerkconfiguratiebestanden (zoals tnsnames.ora) ophalen van de locatie waarnaar TNS_ADMIN wijst.

Instellingen van een eerder geïnstalleerde ODAC gebruiken

Als ODAC eerder is geïnstalleerd en TNS_ADMIN is geconfigureerd, detecteert Power BI automatisch TNS_ADMIN.

De resterende configuraties voor het maken van verbinding met een Oracle-database vanuit Power Query Desktop zijn hetzelfde als in de vorige secties.

Lijst met toegestane eigenschappen

Gebruikers kunnen Oracle-servernamen opgeven met behulp van verbindingsdescriptors zoals (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name))). Het systeem dwingt af welke eigenschappen kunnen worden gebruikt in Desktop en Gateway. De standaard toegestane eigenschappen ODAC.config worden in de volgende sectie vermeld.

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

Gebruikers kunnen deze lijst met toegestane eigenschappen wijzigen als ze nieuwe eigenschappen moeten toevoegen of eigenschappen uit de lijst moeten verwijderen om strengere regels af te dwingen.

Opmerking

Belangrijke beperkingen

• Het ingebouwde Oracle-beheerde ODP.NET-driver voor DirectQuery is beschikbaar als preview. Zie de voorgaande DirectQuery-secties voor meer informatie.
• Het bestand ODAC.config mogelijk beheerdersrechten nodig heeft om te bewerken en de Power BI Store-app staat het wijzigen van dit bestand niet toe.
• De wijzigingen die zijn aangebracht in ODAC.config worden overschreven tijdens de upgrade en u moet het bestand opslaan op een andere locatie voordat u een upgrade uitvoert.
• Om ervoor te zorgen dat de on-premises gegevensgateway goed werkt, moet de gebruiker waaronder de gatewayservice draait toegang hebben tot de map die wordt aangeduid door TNS_ADMIN.
• Start Power BI Desktop of de on-premises Data Gateway-service opnieuw nadat u configuratiewijzigingen hebt toegepast.

Beperkingen en overwegingen

Power BI-sessies kunnen nog ongeveer 30 minuten na het vernieuwen van een semantisch model naar die Oracle-database actief zijn in uw Oracle-database. Pas na ongeveer 30 minuten worden deze sessies inactief/verwijderd in de Oracle-database. Dit gedrag is opzettelijk ontworpen.

Probleemoplossingsproces

U kunt verschillende fouten van Oracle tegenkomen wanneer de naamgevingsyntaxis onjuist is of niet juist is geconfigureerd:

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

Deze fouten kunnen optreden als de Oracle tnsnames.ora-databaseverbindingsdescriptor onjuist is geconfigureerd, de opgegeven netservicenaam onjuist is gespeld of de Oracle-databaselistener niet wordt uitgevoerd of niet bereikbaar is, zoals een firewall die de listener of databasepoort blokkeert. Zorg ervoor dat u voldoet aan de minimale installatievereisten. Meer informatie: Vereisten

Ga naar de Help-portal voor Oracle-databasefouten om veelvoorkomende oorzaken en oplossingen te bekijken voor de specifieke Oracle-fout die u tegenkomt. Voer uw Oracle-fout in de zoekbalk van de portal in.

Wanneer u DirectQuery gebruikt via de on-premises gegevensgateway met het ingebouwde Oracle-stuurprogramma, kunnen fouten zoals het volgende erop wijzen dat een TNS-alias niet kan worden opgelost:

• ORA-12154: TNS name resolution failure
• ORA-50201: Failed to connect to server

Als u deze fouten tegenkomt, controleer dan of TNS_ADMIN is ingesteld op systeemniveau (computer) en of het serviceaccount van de gateway toegang heeft tot de map waarnaar deze verwijst, en start vervolgens de on-premises-gegevensgatewayservice opnieuw op. Zie Ondersteunde manieren om TNS_ADMIN op te geven met het ingebouwde Oracle-stuurprogramma en de handleiding voor het oplossen van problemen met Oracle Net Services voor meer informatie.

Bekende problemen met het ingebouwde Oracle-stuurprogramma

De volgende bekende problemen zijn specifiek voor het ingebouwde door Oracle beheerde ODP.NET stuurprogramma. Verschillende tijdelijke oplossingen vallen terug op de ODP.NET onbeheerde stuurprogramma door het ingebouwde stuurprogramma uit te schakelen. Zie Het ingebouwde Oracle-stuurprogramma gebruiken voor de uitzetstappen voor elk oppervlak, Power BI Desktop Importeren en DirectQuery, en gateway importeren en DirectQuery.

TNS-aliassen op een netwerkshare worden niet omgezet

Is van toepassing op de on-premises gegevensgateway, zowel in Import als DirectQuery.

Wanneer uw Oracle-netwerkconfiguratiebestanden (tnsnames.ora of de TNS_ADMIN map) zijn opgeslagen op een netwerkshare (UNC-pad), kan het ingebouwde stuurprogramma de netservicenaam (TNS-alias) consistent niet oplossen. Mogelijk ziet u ORA-12154: TNS:could not resolve the connect identifier specified of ORA-50201: Failed to connect to server. Dezelfde alias wordt correct omgezet met het ODP.NET niet-beheerde stuurprogramma of wanneer de bestanden zich op een lokaal pad bevinden. Het ingebouwde beheerde stuurprogramma leest oracle-netwerkconfiguratiebestanden niet betrouwbaar vanaf een UNC-locatie.

Gebruik een van de volgende tijdelijke oplossingen:

• Kopieer tnsnames.ora (en sqlnet.ora als u deze gebruikt) naar een map op een lokaal station en wijs vervolgens het stuurprogramma aan die map. Zie Ondersteunde manieren om TNS_ADMIN op te geven met het ingebouwde Oracle-stuurprogramma. Stel voor Gateway DirectQuery TNS_ADMIN het systeembereik (computer) in, omdat het gatewayserviceaccount geen variabelen met gebruikersbereik kan lezen en vervolgens de gatewayservice opnieuw kan starten.
• Zorg ervoor dat het serviceaccount waarop de gateway wordt uitgevoerd, toegang heeft tot de netwerkshare.
• Voer een Easy Connect-descriptor rechtstreeks in server (bijvoorbeeld host:port/service_name) in in plaats van een tnsnames.ora alias, dus er is geen netwerkconfiguratiebestand nodig.
• Schakel het ingebouwde stuurprogramma uit om terug te vallen naar het ODP.NET niet-beheerde stuurprogramma, waarmee de bestanden uit de share kunnen worden gelezen.

NLS_LANG wordt genegeerd

Is van toepassing op Power BI Desktop, de on-premises gegevensgateway en Power BI-service cloudverbindingen in zowel Import als DirectQuery.

Met het ingebouwde stuurprogramma, oracle-sessietaal, gebied en getal- en datumnotaties volgt u de .NET cultuur van de machine (Windows regionale en indelingsinstellingen), niet de NLS_LANG omgevingsvariabele. Het instellen of wijzigen NLS_LANG heeft geen effect. Afhankelijk van het gebied van de machine kan dit gedrag ertoe leiden dat getallen of datums worden geparseerd met de verkeerde scheidingstekens of datumvolgorde, query's nul rijen of onjuiste waarden retourneren, of fouten zoals ORA-01722, ORA-01858, ORA-01861of ORA-01843. Een rapport dat is gemaakt op een computer die is ingesteld op Engels (Verenigde Staten) kan bijvoorbeeld nul rijen of fouten retourneren op een computer die is ingesteld op Engels (Verenigd Koninkrijk). Het beheerde ODP.NET stuurprogramma leidt de NLS-instellingen (National Language Support) af van de .NET threadcultuur in plaats van van NLS_LANG, in tegenstelling tot de ODP.NET onbeheerde driver, die eert NLS_LANG.

Gebruik een van de volgende tijdelijke oplossingen:

• Koppel de landinstellingen van de machine aan de landinstellingen waarvoor uw gegevens en query's zijn ontworpen.
• Schakel het ingebouwde stuurprogramma uit om terug te vallen op de ODP.NET onbeheerde chauffeur, die eert NLS_LANG.

Zie de documentatie over de globalisatieondersteuning van Oracle voor achtergrondinformatie over het globalisatiegedrag van het beheerde stuurprogramma.

FetchSize in het register wordt niet gebruikt door het ingebouwde stuurprogramma

Is van toepassing op Power BI Desktop en de on-premises gegevensgateway voor Oracle Import-modellen.

Nadat u overschakelt naar het ingebouwde stuurprogramma, worden Oracle Import-modellen mogelijk langzamer vernieuwd dan met het ODP.NET onbeheerde stuurprogramma. De ingebouwde beheerde ODP.NET-provider leest de FetchSize eigenschap niet uit het register. De standaardwaarde FetchSize voor de ODP.NET niet-beheerde en beheerde providers is 128 KB in versie 23.26.2 en eerder, inclusief de 23.6-provider die Power BI bevat. De beheerde provider negeert eventuele FetchSize onderdrukkingen die zijn geconfigureerd in het register.

Schakel het ingebouwde stuurprogramma uit om terug te vallen op de ODP.NET onbeheerde stuurprogramma, die de registerinstelling FetchSize respecteert. Stel in de on-premises gegevensgateway MashupFlight_DisableOracleBundledOdacProviderV2True in de configuratie van de gebundelde provider in de gateway-instellingen in.

Verificatie van Oracle-proxygebruikers wordt niet ondersteund

Is van toepassing op de on-premises gegevensgateway (versie van juni 2026 en hoger) voor Oracle Import en DirectQuery die gebruikmaken van een Oracle-proxyaccount.

Nadat u een upgrade hebt uitgevoerd naar de gateway van juni 2026, die standaard is ingesteld op de ingebouwde beheerde provider, Power BI rapporten die verbinding maken met Oracle met behulp van een Oracle-proxyaccount mislukken in zowel Import als DirectQuery. Dezelfde gegevensbron werkt wanneer de verbinding gebruikmaakt van een niet-proxy Oracle-account. Verificatie van Oracle Database-proxygebruikers, die verbinding maken als één databasegebruiker namens een ander schema (bijvoorbeeld het User Id=proxy_user[target_schema] formulier) wordt niet ondersteund door versie 23.6 van de ingebouwde beheerde ODP.NET-provider die momenteel wordt geleverd met Power BI.

Gebruik een van de volgende tijdelijke oplossingen:

• Gebruik waar mogelijk een Niet-proxy Oracle-account.
• Schakel voor Importeren het ingebouwde stuurprogramma voor Importeren op de gateway uit door in te Truestellen MashupFlight_DisableOracleBundledOdacProviderV2 op , zodat de gateway terugvalt op het ODP.NET niet-beheerde stuurprogramma, dat proxyaccounts ondersteunt.
• Voor DirectQuery is de importinstelling niet van toepassing. Neem contact op met Microsoft Ondersteuning om het ingebouwde stuurprogramma voor het DirectQuery-pad van de gateway uit te schakelen. Deze configuratie is momenteel geen selfservice.

Kan de verbindingsreferenties van Oracle personal cloud niet bijwerken

Is van toepassing op de Power BI-service voor persoonlijke Oracle-cloudverbindingen.

Op de pagina Verbindingen en gateways beheren in de Power BI-service werkt het bijwerken van de referenties van een persoonlijke Oracle-cloudverbinding niet. Werk in plaats daarvan de referenties bij vanuit het deelvenster semantische modelinstellingen:

1. Open het deelvenster met semantische modelinstellingen en ga naar Gateway- en cloudverbindingen.
2. Stel de gegevensbron in om de persoonlijke cloudverbinding te gebruiken.
3. Bewerk onder Gegevensbronreferenties de referenties voor de gegevensbron.

Als u Power BI Desktop hebt gedownload vanuit de Microsoft Store, kunt u mogelijk geen verbinding maken met Oracle-databases vanwege een probleem met het Oracle-stuurprogramma. Als u dit probleem tegenkomt, wordt het geretourneerde foutbericht weergegeven: Objectverwijzing is niet ingesteld. Als u het probleem wilt oplossen, downloadt u Power BI Desktop vanuit het Downloadcentrum in plaats van microsoft Store.

Als het foutbericht Objectverwijzing niet is ingesteld in Power BI wanneer u verbinding maakt met een Oracle-database met behulp van de on-premises gegevensgateway, volgt u de instructies in Uw gegevensbron beheren - Oracle.

Als u Power BI Report Server gebruikt, raadpleegt u de richtlijnen in het artikel Oracle Connection Type .

Verwante inhoud

Power Query optimaliseren bij het uitvouwen van tabelkolommen