Oracle-database

Samenvatting

Vereiste voorwaarden

Ondersteunde Oracle-versies:

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

Voordat u verbinding kunt maken met een Oracle-database met behulp van Power Query, moet u de Oracle-client voor Microsoft Tools (OCMT) installeren. Als u verbinding wilt maken met een Oracle-database via de on-premises gegevensgateway, moet 64-bits OCMT zijn geïnstalleerd op de computer waarop de gateway draait. Ga voor meer informatie naar Uw gegevensbron beheren - Oracle.

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

Oracle Client voor Microsoft Tools downloaden en installeren

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

   Opmerking

   U moet een on-premises gegevensgateway voor deze connector selecteren, ongeacht of de Oracle-database zich in uw lokale netwerk of op een website bevindt.

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

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)
• On-premises gegevensgateway als u de Power BI-service gebruikt (een standaardgateway downloaden en installeren)

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.

De gateway configureren

1. Een op locatie gegevensgateway installeren en instellen.

2. Selecteer in de Power BI-service het tandwielpictogram in de rechterbovenhoek en selecteer vervolgens Gateways beheren.

   

3. Selecteer in Gegevensbron toevoegende optie Gegevensbronnen toevoegen om de gateway te gebruiken.

   

4. Voer in De naam van de gegevensbron de naam in die u wilt gebruiken als de instelling voor de gegevensbron.

5. Selecteer Oracle in het gegevensbrontype.

6. Voer in Server de netservicenaam in van de Oracle Autonomous Database-server waarmee u verbinding wilt maken.

7. Selecteer Basic in verificatiemethode.

8. Voer de gebruikersnaam en het wachtwoord in voor de Oracle Autonomous Database. In dit voorbeeld worden de gebruikersnaam en het wachtwoord van de standaarddatabasebeheerder gebruikt.

9. Selecteer Toevoegen.

   

Als alles correct is geïnstalleerd en geconfigureerd, verschijnt het bericht verbinding geslaagd. U kunt nu verbinding maken met de Autonome Oracle-database met behulp van dezelfde stappen die worden beschreven in Verbinding maken met een on-premises Oracle-database vanuit Power Query Online.

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.

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 (preview)

Sinds de versie van april 2025 van Power BI Desktop en mei 2025 van de on-premises gegevensgateway bevat de Oracle-connector 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 inschakelen met behulp van 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 in om de optie Inschakelen met behulp van gebundelde Oracle Managed ODP-provider in te schakelen.

Als u dit ingebouwde stuurprogramma in de on-premises gegevensgateway wilt gebruiken, wijzigt u de gatewayconfiguraties om de MashupFlight_EnableOracleBundledOdacProvider 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_EnableOracleBundledOdacProvider vermelding.
4. Werk de MashupFlight_EnableOracleBundledOdacProvider waarde bij als True.
5. Start de gateway opnieuw op.

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

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

Bekende problemen en beperkingen

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.

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