Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Sammanfattning
| Objekt | Beskrivning |
|---|---|
| Frisläppningsstatus | Allmän tillgänglighet |
| Produkter | Excel Power BI (semantiska modeller) Power BI (dataflöden) Fabric (Dataflöde Gen2) Power Apps (dataflöden) Dynamics 365 Customer Insights Analystjänster |
| Autentiseringstyper som stöds | Windows (skrivbord/online) Databas (skrivbord) Grundläggande (online) Microsoft-konto (skrivbord) |
| Dokumentation om funktionsreferens | Oracle.Database |
Anmärkning
Vissa funktioner kan finnas i en produkt, men inte andra på grund av distributionsscheman och värdspecifika funktioner.
Förutsättningar
Oracle-versioner som stöds:
- Oracle Database Server 12c (12.1.0.2) och senare
- Oracle Autonomous Database – alla versioner
Från och med april 2025-versionen av Power BI Desktop och maj 2025-versionen av den lokala datagatewayen kan du använda den inbyggda Oracle-hanterade ODP.NET-drivrutinen för att ansluta till Oracle-databasen. När du aktiverar den här funktionen behöver du inte installera OCMT manuellt. Från och med juni 2026 kan du också skapa en molnanslutning till Oracle Autonomous Database eller andra Oracle-molnslutpunkter utan en gateway. Läs mer om den här funktionen.
Om du inte använder den nya inbyggda Oracle-drivrutinen måste du använda en lokal företagsdatagateway och installera 64-bitars Oracle-klienten för Microsoft Tools (OCMT) på datorn som kör gatewayen eller Power BI Desktop. Mer information finns i Hantera din datakälla – Oracle.
Funktioner som stöds
- Importera
- DirectQuery (Power BI-semantiska modeller)
- Avancerade alternativ
- Tidsgräns för kommando i minuter
- SQL-instruktion
- Inkludera relationskolumner
- Navigera med fullständig hierarki
Alternativet Använda Oracle-klienten för Microsoft Tools (OCMT)
Oracle-klienten för Microsoft Tools installerar och konfigurerar Oracle Data Provider för .NET (ODP.NET) för att stödja 32-bitars och 64-bitars Microsoft-verktygsanslutningar med Oracles lokala databaser och molndatabaser, inklusive Oracle Autonomous Database (ADB). OCMT är ett grafiskt installationsprogram som automatiserar installationsprocessen för Oracle Database-klienten. Det stöder anslutning med Power BI Desktop, Power BI-tjänsten, Fabric (Dataflöde Gen2), Excel, SQL Server Analysis Services, SQL Server Data Tools, služba SSIS, SQL Server Reporting Services och BizTalk Server.
OCMT är kostnadsfri programvara. Den kan laddas ned från sidan Oracle-klient för Microsoft Tools. För 64-bitars Power BI Desktop och Power BI-tjänsten använder du 64-bitars OCMT. För 32-bitars Power BI Desktop använder du 32-bitars OCMT.
Även om du redan har en Oracle-klient eller ODP.NET installerad på Power BI-klienten rekommenderar vi starkt att du använder OCMT-installationsprogrammet för att slutföra alla konfigurationssteg som Power BI kräver för att arbeta med Oracle-databasen.
Ansluta till en lokal Oracle-databas från Power BI Desktop
Utför följande steg för att upprätta anslutningen:
Välj alternativet Oracle-databas i valet av anslutningsapp.
Ange Oracle net service name/TNS alias eller Easy Connect -anslutningssträngen (Plus) som ska anslutas till i Server. Easy Connect är det mest lättanvända sättet genom att ställa in servervärdet för din Oracle Database-server till värdnamn/ServiceName, där ServiceName är det globala databasnamnet. Följande skärmbild använder ett net-tjänstnamn.
Om du ansluter från Power BI Desktop väljer du antingen dataanslutningsläget Importera eller DirectQuery . Resten av de här exempelstegen använder anslutningsläget Importera data. Mer information om DirectQuery finns i Använda DirectQuery i Power BI Desktop.
Om du ansluter till den här Oracle-databasen för första gången väljer du den autentiseringstyp som du vill använda och anger sedan dina autentiseringsuppgifter. Tillgängliga autentiseringstyper är:
- Windows (Windows-autentisering)
- Databas (användarnamn och lösenord)
- Microsoft-konto (Microsoft Entra-ID)
Mer information om autentisering finns i Autentisering med en datakälla.
I Navigatör väljer du de data du behöver och väljer sedan Läs in för att läsa in data eller Transformera data för att transformera data.
Ansluta till en lokal Oracle-databas från Power Query Online
Utför följande steg för att upprätta anslutningen:
I Power Query Online väljer du alternativet Oracle-databas i valet av datakällor.
I dialogrutan Oracle-databas som visas anger du Oracle net service name/TNS alias, Easy Connect Plus-anslutningssträng eller anslutningsbeskrivning för att ansluta till i Server.
Ange ett anslutningsnamn, till exempel "testoracleserver".
Välj namnet på din lokala datagateway.
Om du ansluter till den här Oracle-databasen för första gången väljer du typen av autentiseringsuppgifter för anslutningen i Typ av autentisering. Välj Grundläggande om du planerar att logga in med ett Oracle-användarnamn och lösenord. Välj Windows när du använder Windows-operativsystemautentisering och med både Oracle-klienten och servern som körs i Windows.
Ange dina autentiseringsuppgifter.
Välj Nästa för att fortsätta.
I Navigatör väljer du de data du behöver och väljer sedan Transformera data för att transformera data i Power Query-redigeraren.
Ansluta till en oracle-autonom databas
Anmärkning
För närvarande kan du ansluta till en Oracle Autonomous Database från Excel, Power BI Desktop, Power BI-tjänsten, Fabric (Dataflow Gen2), Power Apps, SQL Server Analysis Services och BizTalk Server med hjälp av procedurerna i det här avsnittet. Dessa verktyg använder ohanterade ODP.NET för att ansluta. Andra Microsoft-verktyg, inklusive SQL Server Data Tools, služba SSIS och SQL Server Reporting Services, använder hanterade ODP.NET för att ansluta till Oracle Autonomous Database med i stort sett liknande procedurer.
För att ansluta Power BI till en oracle-autonom databas behöver du följande konton och appar:
- Ett Oracle.com konto (Oracle.com kontoregistrering)
- Ett Oracle Cloud-konto (Registrering av Oracle-molnkonto)
- En Oracle Autonomous Database (Hämta en alltid gratis autonom databas)
- Power BI Desktop (Hämta Power BI Desktop) eller Power BI-tjänstkonto (licensiering av Power BI-tjänsten för användare i din organisation)
Ladda ned dina autentiseringsuppgifter för klienten
Det första steget när du konfigurerar en anslutning till den autonoma Oracle-databasen är att ladda ned dina klientautentiseringsuppgifter.
Så här laddar du ned dina klientautentiseringsuppgifter:
Välj DB-anslutning på informationssidan för den autonoma Oracle-databasen.
På sidan Databasanslutning väljer du Ladda ned plånbok.
Ange ett lösenord som du vill använda med den här plånboken, bekräfta lösenordet och välj sedan Ladda ned.
Konfigurera Oracle ADB-autentiseringsuppgifter
På din Windows-dator går du till mappen där du laddade ned dina Oracle ADB-autentiseringsuppgifter från Ladda ned dina klientautentiseringsuppgifter.
Packa upp autentiseringsuppgifterna i den katalog som du angav i OCMT som Oracle Configuration File Directory. I det här exemplet extraheras autentiseringsuppgifterna till c:\data\wallet\wallet_contosomart.
Anmärkning
Filen tnsnames.ora definierar din Oracle Autonomous Database-adress och anslutningsinformation.
Öppna sqlnet.ora i ett redigeringsprogram, till exempel Anteckningar.
Under WALLET_LOCATION ändrar du sökvägen till din plånboksmapp under alternativet Katalog. I det här exemplet:
WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))Spara och stäng filen sqlnet.ora.
Öppna filen tnsnames.ora i mappen wallets. Filen innehåller en lista över ADB net service-namn som du kan ansluta till. I det här exemplet är namnen contosomart_high, contosomart_low och contosomart_medium. Dina ADB-nättjänstnamn skiljer sig åt.
Ansluta Power BI Desktop till Oracle ADB
Öppna Power BI Desktop.
Välj Hämta data.
Från Hämta data väljer du Databas>Oracle-databas.
Ange nettotjänstnamnet för den Oracle Autonomous Database-server som du vill ansluta till. I det här exemplet är servern contosomart_high. Välj sedan OK.
Om du loggar in på den här servern från Power BI Desktop för första gången uppmanas du att ange dina autentiseringsuppgifter. Välj Databas och ange sedan användarnamnet och lösenordet för Oracle-databasen. De autentiseringsuppgifter som du anger här är användarnamnet och lösenordet för den specifika Oracle Autonomous Database som du vill ansluta till. I det här exemplet används databasens första administratörsanvändarnamn och lösenord. Välj sedan Anslut.
Anmärkning
Du kan använda Microsoft Entra ID-autentisering för att logga in på Oracle Autonomous Database via microsoft-kontoalternativet .
Nu visas navigatören och visar anslutningsdata.
Du kan också stöta på ett av flera fel eftersom konfigurationen inte är korrekt konfigurerad. De här felen beskrivs i Felsökning.
Ett fel som kan inträffa i det här inledande testet sker i Navigator, där databasen verkar vara ansluten, men som inte innehåller några data. I stället visas ett Oracle-fel: ORA-28759: det går inte att öppna filen, i stället för data.
Om det här felet inträffar kontrollerar du att sökvägen till plånboksmappen som du angav i sqlnet.ora är den fullständiga och korrekta sökvägen till plånboksmappen.
Ansluta med avancerade alternativ
Power Query Desktop och Power Query Online innehåller en uppsättning avancerade alternativ som du kan lägga till i din fråga om det behövs.
I följande tabell visas alla avancerade alternativ som du kan ange i Power Query Desktop och Power Query Online.
| Avancerad inställning | Beskrivning |
|---|---|
| Tidsgräns för kommando i minuter | Om anslutningen varar längre än 10 minuter (standardtidsgränsen) kan du ange ett annat värde på några minuter för att hålla anslutningen öppen längre. Det här alternativet är bara tillgängligt i Power Query Desktop. |
| SQL-instruktion | Mer information finns i Importera data från en databas med hjälp av intern databasfråga. |
| Inkludera relationskolumner | Om markerat innehåller kolumner som kan ha relationer till andra tabeller. Om den här rutan är avmarkerad visas inte dessa kolumner. |
| Navigera med fullständig hierarki | Om det är markerat visar navigatören den fullständiga hierarkin med tabeller i databasen som du ansluter till. Om det avmarkeras visar navigatören endast de tabeller vars kolumner och rader innehåller data. |
När du har valt de avancerade alternativ som du behöver väljer du OK i Power Query Desktop eller Nästa i Power Query Online för att ansluta till Oracle-databasen.
Använda den inbyggda Oracle-drivrutinen
För importläge i Power BI Desktop
För juni 2026-versionen av Power BI Desktop eller lokal datagateway är standardvärdet att använda en inbyggd Oracle-hanterad ODP.NET drivrutin för anslutning. Den här funktionen tar bort behovet av att användare installerar och hanterar drivrutinen. Du kan fortfarande avanmäla dig från den här funktionen med hjälp av följande instruktioner.
Om du inte vill använda den här inbyggda drivrutinen i Power BI Desktop går du till Alternativ och inställningar (under fliken Arkiv) >Förhandsgranskningsfunktioner> och avmarkerar sedan kryssrutan för att aktivera alternativet Aktivera med paketerad Oracle Managed ODP-provider för importläge.
För DirectQuery-läge i Power BI Desktop (förhandsversion)
För DirectQuery-läge är den inbyggda Oracle-hanterade ODP.NET-drivrutinen fortfarande i förhandsversion. Om du vill anmäla dig använder du följande instruktioner.
Om du vill använda den här inbyggda drivrutinen i Power BI Desktop går du till Alternativ och inställningar (under fliken Arkiv) >Förhandsgranskningsfunktioner> och avmarkerar sedan kryssrutan för att aktivera alternativet Aktivera med paketerad Oracle Managed ODP-provider för DirectQuery-läge.
För importläge i lokal gateway
Från och med juni 2026-versionen använder den lokala datagatewayen den inbyggda Oracle-hanterade ODP.NET drivrutinen för anslutning som standard. Om du inte vill använda den här inbyggda drivrutinen i den lokala datagatewayen för importläge ändrar du gatewaykonfigurationerna för att uppdatera MashupFlight_DisableOracleBundledOdacProviderV2 inställningen med hjälp av följande steg:
- På den lokala datorn där den lokala datagatewayen är installerad navigerar du till C:\Program Files\On-premises data gateway.
- Gör en säkerhetskopia av konfigurationsfilen med namnet Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
- Öppna den ursprungliga Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config konfigurationsfilen och leta upp posten
MashupFlight_DisableOracleBundledOdacProviderV2. - Uppdatera värdet
MashupFlight_DisableOracleBundledOdacProviderV2tillTrue. - Starta om gatewayen.
<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
...
<setting name="MashupFlight_DisableOracleBundledOdacProviderV2" serializeAs="String">
<value>True</value>
</setting>
...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
Anmärkning
När du har ändrat MashupFlight_DisableOracleBundledOdacProviderV2 inställningen i filen Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config sparas konfigurationen över lokala uppgraderingar av datagatewayen.
Anmärkning
Om dina semantiska modeller fortfarande använder en personlig gateway för att ansluta till lokala Oracle-datakällor uppgraderar du till en lokal företagsdatagateway eller virtuell nätverksgateway (VNET) eller flyttar dina Oracle-molnarbetsbelastningar till direkta molnanslutningar. Den uppdaterade Oracle-anslutningsappen stöder inte personliga lokala datagatewayer, detta gäller både importläge och DirectQuery-läge. Befintliga semantiska modeller kan fortsätta att använda en personlig gateway tills du uppdaterar dataanslutningsbindningen. När du har uppdaterat bindningen kan du inte gå tillbaka till den personliga gatewayen. Planera uppgraderingen av Oracle-anslutningen i enlighet med detta.
För DirectQuery-läge i lokal gateway (förhandsversion)
Den lokala datagatewayen kan använda den inbyggda Oracle-hanterade ODP.NET drivrutinen för DirectQuery. Den här funktionen är i förhandsversion.
Om du vill lösa ett TNS-alias för DirectQuery använder du en miljövariabel. Gateway-tjänstkontot kan inte komma åt variabler med användaromfattning, så ange TNS_ADMIN i systemets (datorns) omfång och starta sedan om den lokala datagatewaytjänsten.
Den inbyggda drivrutinen stöder inte Oracle proxy-user-autentisering. Mer information och lösningar finns i Oracle proxy-user authentication isn't supported.
Sätt som stöds för att ange TNS_ADMIN med den inbyggda Oracle-drivrutinen
Det finns tre alternativ för att ange TNS_ADMIN:
- Konfigurera TNS_ADMIN i OADC.config
- Använda en miljövariabel
- Använda inställningar från en tidigare installerad OADC
Konfigurera TNS_ADMIN i ODAC.config
Om du använder den inbyggda Oracle-drivrutinen och har åtkomst till att ändra programfiler kan du ange TNS_ADMIN i konfigurationsfilen ODAC.config som används av inbyggd Oracle-drivrutin. Filen finns på platsen där Power BI Desktop eller den lokala datagatewayen är installerad, under undermappen "ADO.NET Providers". Följande är ett exempel på hur du anger TNS_ADMIN sökväg som är "C:\network\admin".
Det här konfigurationsvärdet har företräde framför andra alternativ.
Exempelkonfiguration
<configuration>
...
<oracle.manageddataaccess.client>
<version number="*">
<settings>
<setting name="TNS_ADMIN" value="C:\network\admin" />
</settings>
</version>
</oracle.manageddataaccess.client>
...
</configuration>
Observera att TNS_ADMIN som konfigurerats i ODAC.config har företräde framför en TNS_ADMIN inställning i miljön.
Använda en miljövariabel
Om användaren inte har åtkomst till att ändra ODAC.configkan de ange TNS_ADMIN genom att lägga till en TNS_ADMIN miljövariabel. Miljövariabeln kan vara en systemmiljövariabel eller en användarmiljövariabel för den användare som kör Power BI Desktop eller den lokala datagatewayen. Ange till exempel värdet TNS_ADMIN "C:\network\admin".
Om du ställer in TNS_ADMIN i miljön (särskilt på systemnivå) kan andra program som körs på den här datorn hämta nätverkskonfigurationsfilerna (till exempel tnsnames.ora) från den plats som TNS_ADMIN pekar på.
Använda inställningar från en tidigare installerad ODAC
Om ODAC har installerats tidigare och TNS_ADMIN har konfigurerats identifierar Power BI automatiskt TNS_ADMIN.
De återstående konfigurationerna för att ansluta till en Oracle-databas från Power Query Desktop är desamma som beskrivs i föregående avsnitt.
Lista över tillåtna egenskaper
Användare kan ange Oracle-servernamn med hjälp av anslutningsbeskrivningar, till exempel (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name))).
Systemet tillämpar vilka egenskaper som kan användas i Desktop och Gateway. De tillåtna standardegenskaperna i ODAC.config visas i följande avsnitt.
<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>
Användare kan ändra den här tillåtna egenskapslistan om de behöver lägga till nya egenskaper eller ta bort egenskaper från listan för att tillämpa strängare regler.
Anmärkning
Viktiga begränsningar
- Användning av den inbyggda Oracle-hanterade ODP.NET-drivrutinen för DirectQuery är i förhandsversion. Mer information finns i föregående DirectQuery-avsnitt.
- Filen ODAC.config kan kräva administratörsbehörighet för redigering och Power BI Store-appen tillåter inte att den här filen ändras.
- Ändringarna i ODAC.config skrivs över under uppgraderingen och du måste spara filen på en annan plats före uppgraderingen.
- För att den lokala datagatewayen ska fungera korrekt kontrollerar du att användaren som gatewaytjänsten körs under har åtkomst till mappen som pekas på av TNS_ADMIN.
- Starta om Power BI Desktop eller den lokala Data Gateway-tjänsten när du har tillämpat konfigurationsändringar.
Begränsningar och överväganden
Power BI-sessioner kan fortfarande vara aktiva i Oracle-databasen i ungefär 30 minuter efter en semantisk modelluppdatering till Oracle-databasen. Först efter cirka 30 minuter blir dessa sessioner inaktiva/borttagna i Oracle-databasen. Det här beteendet är avsiktligt.
Felsökning
Du kan stöta på något av flera fel från Oracle när namngivningssyntaxen antingen är felaktig eller inte har konfigurerats korrekt:
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.
Dessa fel kan inträffa om Oracle tnsnames.ora database connect-beskrivningen är felkonfigurerad, det angivna nettotjänstnamnet är felstavat eller om Oracle-databaslyssnaren inte körs eller inte kan nås, till exempel en brandvägg som blockerar lyssnaren eller databasporten. Se till att du uppfyller minimikraven för installation. Mer information: Förutsättningar
Gå till hjälpportalen för Oracle Database-fel för att granska vanliga orsaker och lösningar för det specifika Oracle-fel som du stöter på. Ange ditt Oracle-fel i portalens sökfält.
När du använder DirectQuery via den lokala datagatewayen med den inbyggda Oracle-drivrutinen kan fel som följande tyda på att ett TNS-alias inte kan lösas:
ORA-12154: TNS name resolution failureORA-50201: Failed to connect to server
Om du stöter på dessa fel kontrollerar du att det TNS_ADMIN är inställt på systemets (datorns) omfång och att gatewaytjänstkontot kan komma åt mappen som det pekar på och starta sedan om den lokala datagatewaytjänsten. Mer information finns i Sätt som stöds för att ange TNS_ADMIN med den inbyggda Oracle-drivrutinen och Oracles felsökningsguide för Oracle Net Services .
Kända problem med den inbyggda Oracle-drivrutinen
Följande kända problem är specifika för den inbyggda Oracle-hanterade ODP.NET drivrutinen. Flera av lösningarna återgår till ODP.NET ohanterad drivrutin genom att stänga av den inbyggda drivrutinen. För avstängningsstegen för varje yta – Power BI Import och DirectQuery för skrivbord och gatewayimport och DirectQuery – kan du läsa Använda den inbyggda Oracle-drivrutinen.
TNS-alias på en nätverksresurs matchas inte
Gäller för den lokala datagatewayen i både Import och DirectQuery.
När oracle-nätverkskonfigurationsfilerna TNS_ADMIN (tnsnames.ora eller katalogen) lagras på en nätverksresurs (UNC-sökväg) kan den inbyggda drivrutinen konsekvent inte matcha nättjänstnamnet (TNS-alias). Du kan se ORA-12154: TNS:could not resolve the connect identifier specified eller ORA-50201: Failed to connect to server. Samma alias matchar korrekt med ODP.NET ohanterad drivrutin eller när filerna finns på en lokal sökväg. Den inbyggda hanterade drivrutinen läser inte Oracle-nätverkskonfigurationsfiler från en UNC-plats på ett tillförlitligt sätt.
Använd någon av följande lösningar:
- Kopiera
tnsnames.ora(ochsqlnet.oraom du använder den) till en mapp på en lokal enhet och peka sedan drivrutinen i den mappen. Se Sätt som stöds för att ange TNS_ADMIN med den inbyggda Oracle-drivrutinen. För gateway DirectQuery anger duTNS_ADMINi systemets (datorns) omfång, eftersom gatewaytjänstkontot inte kan läsa variabler med användaromfattning och sedan starta om gatewaytjänsten. - Kontrollera att tjänstkontot som kör gatewayen har åtkomst till nätverksresursen.
- Ange en Easy Connect-beskrivning direkt i Server (till exempel
host:port/service_name) i stället för etttnsnames.oraalias, så ingen nätverkskonfigurationsfil behövs. - Inaktivera den inbyggda drivrutinen för att återgå till ODP.NET ohanterad drivrutin som kan läsa filerna från resursen.
NLS_LANG ignoreras
Gäller för Power BI Desktop, den lokala datagatewayen och služba Power BI molnanslutningar i både Import och DirectQuery.
Med den inbyggda drivrutinen följer Oracle-sessionsspråk, områdes- och nummer- och datumformat datorns .NET kultur (Windows nationella inställningar och formatinställningar), inte NLS_LANG miljövariabeln. Inställningen eller ändringen NLS_LANG har ingen effekt. Beroende på datorns region kan det här beteendet göra att tal eller datum parsas med fel avgränsare eller datumordning, att frågor returnerar noll rader eller felaktiga värden eller fel som ORA-01722, ORA-01858, ORA-01861eller ORA-01843. En rapport som skapats på en dator som är inställd på engelska (United States) kan till exempel returnera noll rader eller fel på en dator som är inställd på engelska (Storbritannien). Den hanterade ODP.NET-drivrutinen härleder sina NLS-inställningar (National Language Support) från .NET trådkulturen i stället för från , till skillnad från NLS_LANGODP.NET ohanterad drivrutin, som respekterar NLS_LANG.
Använd någon av följande lösningar:
- Matcha datorns regionala inställningar med de nationella inställningar som dina data och frågor har utformats för.
- Inaktivera den inbyggda drivrutinen för att återgå till ODP.NET ohanterad drivrutin, som respekterar
NLS_LANG.
Bakgrund om den hanterade drivrutinens globaliseringsbeteende finns i dokumentationen för Oracles support för globalisering .
FetchSize i registret används inte av den inbyggda drivrutinen
Gäller för Power BI Desktop och den lokala datagatewayen för Oracle Import-modeller.
När du har växlat till den inbyggda drivrutinen kan Oracle Import-modeller uppdateras långsammare än med ODP.NET ohanterad drivrutin. Den inbyggda hanterade ODP.NET-providern läser FetchSize inte egenskapen från registret. Standardvärdet FetchSize för ODP.NET ohanterade och hanterade providers är 128 KB i version 23.26.2 och tidigare, inklusive 23.6-providern som Power BI innehåller. Den hanterade providern ignorerar alla FetchSize åsidosättningar som konfigurerats i registret.
Inaktivera den inbyggda drivrutinen för att återgå till ODP.NET ohanterad drivrutin, som respekterar registerinställningenFetchSize. På den lokala datagatewayen anger du MashupFlight_DisableOracleBundledOdacProviderV2 till True i paketproviderkonfigurationen i gatewayinställningarna.
Oracle proxy-user-autentisering stöds inte
Gäller för den lokala datagatewayen (juni 2026 och senare) för Oracle Import och DirectQuery som använder ett Oracle-proxykonto.
När du har uppgraderat till gatewayen juni 2026, som är standard för den inbyggda hanterade providern, Power BI rapporter som ansluter till Oracle med hjälp av ett Oracle-proxykonto misslyckas i både Import och DirectQuery. Samma datakälla fungerar när anslutningen använder ett Oracle-konto som inte är proxy. Oracle Database proxy-user authentication – som ansluter som en databasanvändare för ett annat schema (till exempel User Id=proxy_user[target_schema] formuläret) – stöds inte av version 23.6 av den inbyggda hanterade ODP.NET-providern som för närvarande levereras med Power BI.
Använd någon av följande lösningar:
- Använd ett Oracle-konto som inte är en proxyserver där det är möjligt.
- För Importera inaktiverar du den inbyggda drivrutinen för Import på gatewayen genom att ange
MashupFlight_DisableOracleBundledOdacProviderV2till , så attTruegatewayen återgår till ODP.NET ohanterad drivrutin som stöder proxykonton. - För DirectQuery gäller inte importinställningen. Kontakta Microsoft Support för att inaktivera den inbyggda drivrutinen för gatewayens DirectQuery-sökväg. Den här konfigurationen är inte självbetjäning idag.
Det går inte att uppdatera autentiseringsuppgifterna för Oracles personliga molnanslutning
Gäller för služba Power BI för Oracles personliga molnanslutningar.
På sidan Hantera anslutningar och gatewayer i služba Power BI fungerar det inte att uppdatera autentiseringsuppgifterna för en personlig Oracle-molnanslutning. Uppdatera i stället autentiseringsuppgifterna från fönstret för semantiska modellinställningar:
- Öppna fönstret för semantiska modellinställningar och gå till Gateway- och molnanslutningar.
- Ange att datakällan ska använda den personliga molnanslutningen.
- Under Autentiseringsuppgifter för datakälla redigerar du autentiseringsuppgifterna för datakällan.
Om du laddade ned Power BI Desktop från Microsoft Store kanske du inte kan ansluta till Oracle-databaser på grund av ett Oracle-drivrutinsproblem. Om du stöter på det här problemet returneras felmeddelandet: Objektreferensen har inte angetts. Du kan lösa problemet genom att ladda ned Power BI Desktop från Download Center i stället för Microsoft Store.
Om felmeddelandet Objektreferens inte anges i Power BI när du ansluter till en Oracle-databas med hjälp av den lokala datagatewayen följer du anvisningarna i Hantera datakällan – Oracle.
Om du använder Power BI-rapportservern läser du vägledningen i artikeln Oracle-anslutningstyp .