Oracle Database

Sammendrag

Element Beskrivelse
Utgivelsestilstand Generell tilgjengelighet
Produkter Overgå
Power BI (semantiske modeller)
Power BI (dataflyter)
Stoff (Dataflyt gen2)
Power Apps (dataflyter)
Dynamics 365 Customer Insights
Analysis Services
Godkjenningstyper som støttes Windows (skrivebord/på nett)
Database (skrivebord)
Grunnleggende (på nettet)
Microsoft-konto (skrivebord)
Funksjonsreferansedokumentasjon Oracle.Database

Merk deg

Noen funksjoner kan være til stede i ett produkt, men ikke andre på grunn av distribusjonsplaner og vertsspesifikke funksjoner.

Forutsetning

Støttede Oracle-versjoner:

  • Oracle Database Server 12c (12.1.0.2) og nyere
  • Oracle Autonomous Database – alle versjoner

Fra og med april 2025-versjonen av Power BI Desktop og mai 2025-versjonen av lokal datagateway, kan du bruke den innebygde Oracle-administrerte ODP.NET driveren til å koble til Oracle-databasen. Når du aktiverer denne funksjonen, trenger du ikke å installere OCMT manuelt. Fra og med juni 2026 kan du også opprette en skytilkobling til Oracle Autonomous Database eller andre Oracle-skyendepunkter uten gateway. Lær mer om denne funksjonen.

Hvis du ikke bruker den nye innebygde Oracle-driveren, må du bruke en lokal datagateway for virksomheten og installere 64-biters Oracle Client for Microsoft Tools (OCMT) på datamaskinen som kjører gatewayen eller Power BI Desktop. Hvis du vil ha mer informasjon, kan du se Administrere datakilden – Oracle.

Funksjoner som støttes

  • Importer
  • DirectQuery (semantiske Modeller for Power BI)
  • Avanserte alternativer
    • Tidsavbrudd for kommando i minutter
    • SQL-setning
    • Inkluder relasjonskolonner
    • Navigere ved hjelp av hele hierarkiet

Bruk av alternativet Oracle Client for Microsoft Tools (OCMT)

Oracle Client for Microsoft Tools installerer og konfigurerer Oracle dataleverandør for .NET (ODP.NET) til å støtte 32-biters og 64-biters Microsoft-verktøytilkoblinger med lokale Oracle- og skydatabaser, inkludert Oracle Autonomous Database (ADB). OCMT er et grafisk installasjonsprogram som automatiserer installasjonsprosessen for Oracle Database Client. Den støtter tilkobling med Power BI Desktop, Power BI-tjenesten, Fabric (Dataflow Gen2), Excel, SQL Server Analysis Services, SQL Server Data Tools, SQL Server Integration Services, SQL Server Reporting Services og BizTalk Server.

OCMT er gratis programvare. Den kan lastes ned fra Oracle Client for Microsoft Tools-siden. Bruk 64-biters OCMT for 64-biters Power BI Desktop- og Power BI-tjeneste. Bruk 32-biters OCMT for 32-biters Power BI Desktop.

Selv om du allerede har en Oracle-klient eller ODP.NET installert på Power BI-klienten, anbefaler vi på det sterkeste at du bruker OCMT-installasjonsprogrammet til å fullføre alle konfigurasjonstrinnene Power BI krever for å fungere med Oracle-databasen.

Koble til en lokal Oracle-database fra Power BI Desktop

Hvis du vil opprette tilkoblingen, gjør du følgende:

  1. Velg alternativet Oracle-database i det merkede området for koblingen.

  2. Angi Oracle net service name/TNS alias eller Easy Connect (Plus)-tilkoblingsstrengen du vil koble til i Server. Enkel tilkobling er den enkleste å bruke ved å angi serververdien til Oracle Database Server Hostname/ServiceName, der ServiceName er det globale databasenavnet. Skjermbildet nedenfor bruker et nettjenestenavn.

    Skjermbilde av dialogboksen for tilkobling til Oracle-databasen der du skriver inn tilkoblingsinformasjonen for Oracle-databasen.

  3. Hvis du kobler til fra Power BI Desktop, velger du enten Importer eller DirectQuery datatilkoblingsmodus. Resten av disse trinnene i eksemplet bruker modus for import av datatilkobling. Hvis du vil ha mer informasjon om DirectQuery, kan du gå til Bruke DirectQuery i Power BI Desktop.

  4. Hvis du kobler til oracle-databasen for første gang, velger du godkjenningstypen du vil bruke, og deretter skriver du inn legitimasjonen. De tilgjengelige godkjenningstypene er:

    • Windows (Windows-godkjenning)
    • Database (brukernavn og passord)
    • Microsoft-konto (Microsoft Entra ID)

    Hvis du vil ha mer informasjon om godkjenning, kan du gå til Godkjenning med en datakilde.

    Skjermbilde av godkjenningsdialogen der du skriver inn legitimasjonen for Oracle-databasen.

  5. Velg dataene du trenger i Navigator, og velg deretter Last inn for å laste inn dataene, eller Transformer data for å transformere dataene.

Koble til en lokal Oracle-database fra Power Query Online

Hvis du vil opprette tilkoblingen, gjør du følgende:

  1. Installer og konfigurer en lokal datagateway.

  2. Velg Oracle-databasealternativet i datakildevalget fra Power Query Online.

  3. Angi Oracle Net Service-navnet/TNS-aliaset, tilkoblingsstrengen Easy Connect Plus eller tilkoblingsbeskrivelsen du vil koble til i Server, i dialogboksen Oracle-database som vises.

    Skjermbilde av Oracle-databasevinduet der du skriver inn tilkoblingsinformasjonen for Oracle-databasen på nettet.

  4. Angi et tilkoblingsnavn, for eksempel testoracleserver.

  5. Velg navnet på den lokale datagatewayen.

  6. Hvis du kobler til denne Oracle-databasen for første gang, velger du legitimasjonstypen for tilkoblingen i godkjenningstypen. Velg Grunnleggende hvis du har tenkt å logge på med et Oracle-brukernavn og passord. Velg Windows når du bruker Windows-operativsystemgodkjenning og med både Oracle-klienten og serveren som kjører på Windows.

  7. Angi legitimasjonen din.

  8. Velg Neste for å fortsette.

  9. Velg dataene du trenger, i Navigator, og velg deretter Transformer data for å transformere dataene i Power Query-redigering.

Koble til en oracle autonom database

Merk deg

For øyeblikket kan du koble til en oracle-autonom database fra Excel, Power BI Desktop, Power BI-tjenesten, Fabric (Dataflow Gen2), Power Apps, SQL Server Analysis Services og BizTalk Server ved hjelp av prosedyrene i denne delen. Disse verktøyene bruker uadministrerte ODP.NET til å koble til. Andre Microsoft-verktøy, inkludert SQL Server Data Tools, SQL Server Integration Services og SQL Server Reporting Services, bruker administrerte ODP.NET til å koble til Oracle Autonomous Database ved hjelp av stort sett lignende prosedyrer.

Hvis du vil koble Power BI til en oracle-autonom database, trenger du følgende kontoer og apper:

Last ned klientlegitimasjonen

Det første trinnet i konfigurasjonen av en tilkobling til Den autonome Oracle-databasen er å laste ned klientlegitimasjonen.

Slik laster du ned klientlegitimasjonen:

  1. Velg DB-tilkobling på siden for oracle-autonome databasedetaljer.

    Skjermbilde av siden Autonome databaseresultater med DB-tilkoblingsalternativet fremhevet.

  2. Velg Last ned lommeboksiden Databasetilkobling.

    Skjermbilde av Databasetilkobling-siden med alternativet Last ned lommebok understreket.

  3. Skriv inn et passord du vil bruke med denne lommeboken, bekreft passordet, og velg deretter Last ned.

    Skjermbilde av Last ned lommebok-siden der du skriver inn lommebok-passordet ditt.

Konfigurer Oracle ADB-legitimasjon

  1. Gå til mappen der du lastet ned Oracle ADB-legitimasjonen fra Last ned klientlegitimasjonen på Windows-maskinen.

  2. Pakk ut legitimasjonen i katalogen du angav i OCMT som Oracle Configuration File Directory. I dette eksemplet trekkes legitimasjonen ut til c:\data\wallet\wallet_contosomart.

    Skjermbilde med lommebokfilene pakket ut i lommebokmappen.

    Merk deg

    Filen tnsnames.ora definerer oracle-databaseadressen og tilkoblingsinformasjonen.

  3. Åpne sqlnet.ora i et redigeringsprogram, for eksempel Notisblokk.

  4. Endre banen til lommebokmappen under WALLET_LOCATION. I dette eksemplet:

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

  5. Lagre og lukk sqlnet.ora-filen.

Åpne tnsnames.ora-filen i mappen lommebøker. Filen inneholder en liste over nettjenestenavn for ADB som du kan koble til. I dette eksemplet er navnene contosomart_high, contosomart_low og contosomart_medium. ADB-nettjenestenavnene dine er forskjellige.

Skjermbilde med tre eksempler på TNS-navn, contosomart_high, contosomart_low og contosomart_medium.

Koble Power BI Desktop til Oracle ADB

  1. Åpne Power BI Desktop.

  2. Velg Hent data.

  3. Velg Database> fra Hent data.

  4. Skriv inn nettjenestenavnet for Oracle Autonomous Database-serveren du vil koble til. I dette eksemplet er serveren contosomart_high. Velg deretter OK.

    Skjermbilde av Oracle-databasedialogen med contosomart_high som servernavn og importmodus valgt.

  5. Hvis du logger på denne serveren fra Power BI Desktop for første gang, blir du bedt om å angi legitimasjonen din. Velg Database, og skriv deretter inn brukernavnet og passordet for Oracle-databasen. Legitimasjonen du angir her, er brukernavnet og passordet for den spesifikke oracle-autonome databasen du vil koble til. I dette eksemplet brukes databasens opprinnelige administratorbrukernavn og passord. Velg deretter Koble til.

    Skjermbilde av dialogboksen for legitimasjon, med Database valgt, og standard brukernavn og passord for databasen angitt.

    Merk deg

    Du kan bruke Microsoft Entra ID-godkjenning til å logge på Oracle Autonomous Database via Microsoft-kontoalternativet .

På dette tidspunktet vises navigatøren og viser tilkoblingsdataene.

Skjermbilde av Navigator med den contosomart_high databasen åpen.

Du kan også komme over en av flere feil fordi konfigurasjonen ikke er riktig konfigurert. Disse feilene beskrives i feilsøking.

Én feil som kan oppstå i denne første testen, finner sted i Navigator, der databasen ser ut til å være tilkoblet, men inneholder ingen data. I stedet vises et Oracle: ORA-28759: Feil under åpning av filfeil i stedet for dataene.

Skjermbilde av Navigator med databasenavnet øverst, men det vises en feil i stedet for dataene.

Hvis denne feilen oppstår, må du kontrollere at mappebanen for lommeboken du har angitt i sqlnet.ora, er den fullstendige og riktige banen til lommebokmappen.

Koble til ved hjelp av avanserte alternativer

Power Query Desktop og Power Query Online inneholder et sett med avanserte alternativer som du kan legge til i spørringen om nødvendig.

Tabellen nedenfor viser alle de avanserte alternativene du kan angi i Power Query Desktop og Power Query Online.

Avansert alternativ Beskrivelse
Tidsavbrudd for kommando i minutter Hvis tilkoblingen varer lenger enn 10 minutter (standard tidsavbrudd), kan du angi en annen verdi i minutter for å holde tilkoblingen åpen lenger. Dette alternativet er bare tilgjengelig i Power Query Desktop.
SQL-setning Hvis du vil ha informasjon, kan du gå til Importere data fra en database ved hjelp av opprinnelig databasespørring.
Inkluder relasjonskolonner Hvis merket, inkluderer kolonner som kan ha relasjoner til andre tabeller. Hvis denne boksen er fjernet, vises ikke disse kolonnene.
Navigere ved hjelp av hele hierarkiet Hvis det er merket av for dette, viser navigatøren det fullstendige hierarkiet av tabeller i databasen du kobler til. Hvis den fjernes, viser navigatøren bare tabellene med kolonner og rader som inneholder data.

Når du har valgt de avanserte alternativene du trenger, velger du OK i Power Query Desktop eller Neste i Power Query Online for å koble til Oracle-databasen.

Bruk den innebygde Oracle-driveren

For importmodus i Power BI Desktop

For juni 2026-versjonen av Power BI Desktop eller lokal datagateway, er standarden å bruke en innebygd Oracle-administrert ODP.NET-driver for tilkobling. Denne funksjonen fjerner nødvendigheten av at brukere installerer og administrerer driveren. Du kan fortsatt velge bort denne funksjonen ved å bruke følgende instruksjoner.

For å unngå å bruke denne innebygde driveren i Power BI Desktop, gå til Innstillinger og innstillinger (under fanen Filer) >Innstillinger>Forhåndsvisning, og fjern deretter avkrysningsboksen for å aktivere alternativet Aktiver ved hjelp av medfølgende Oracle Managed ODP Provider for Import Mode.

Skjermbilde av alternativet for å aktivere ved hjelp av buntet Oracle-administrert ODP-leverandør i Power BI Desktop.

For DirectQuery-modus i Power BI Desktop (Forhåndsvisning)

For DirectQuery-modus er bruk av den innebygde Oracle-administrerte ODP.NET-driveren fortsatt i forhåndsvisning. For å melde deg på, bruk følgende instruksjoner.

For å bruke denne innebygde driveren i Power BI Desktop, gå til Innstillinger og innstillinger (under fanen Filer) >Innstillinger>Forhåndsvisning-funksjoner, og fjern deretter avkrysningsboksen for å aktivere alternativet Aktiver ved bruk av Oracle Managed ODP Provider for DirectQuery Mode.

For importmodus i lokal gateway

Fra og med juni 2026-versjonen bruker den lokale datagatewayen den innebygde Oracle-administrerte ODP.NET-driveren for tilkobling som standard. For å unngå å bruke denne innebygde driveren i den lokale datagatewayen for importmodus, endre gateway-konfigurasjonene for å oppdatere innstillingen MashupFlight_DisableOracleBundledOdacProviderV2 ved å bruke følgende steg:

  1. Gå til C:\Programfiler\Lokal datagatewaypå den lokale datamaskinen der den lokale datagatewayen er installert.
  2. Ta en sikkerhetskopi av konfigurasjonsfilen med navnet Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
  3. Åpne den opprinnelige Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config konfigurasjonsfilen, og finn MashupFlight_DisableOracleBundledOdacProviderV2 oppføringen.
  4. Oppdater MashupFlight_DisableOracleBundledOdacProviderV2 verdien til True.
  5. Start gatewayen på nytt.
<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_DisableOracleBundledOdacProviderV2" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>    

Merk deg

Når du endrer MashupFlight_DisableOracleBundledOdacProviderV2 innstillingen i Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config-filen, beholdes konfigurasjonen over lokale oppgraderinger av datagatewayen.

Merk deg

Hvis de semantiske modellene fortsatt bruker en personlig gateway til å koble til lokale Oracle-datakilder, kan du oppgradere til en lokal datagateway eller virtuell nettverksgateway (VNET) eller flytte oracle-arbeidsbelastningene i skyen til direkte skytilkoblinger. Den oppdaterte Oracle-koblingen støtter ikke personlige lokale datagatewayer, dette gjelder både for importmodus og DirectQuery-modus. Eksisterende semantiske modeller kan fortsette å bruke en personlig gateway til du oppdaterer datatilkoblingsbindingen. Når du har oppdatert bindingen, kan du ikke gå tilbake til den personlige gatewayen. Planlegg Oracle-tilkoblingsoppgraderinger tilsvarende.

For DirectQuery-modus i lokal gateway (Forhåndsvisning)

Den lokale datagatewayen kan bruke den innebygde Oracle-administrerte ODP.NET driveren for DirectQuery. Denne funksjonen er i forhåndsversjon.

Hvis du vil løse et TNS-alias for DirectQuery, bruker du en miljøvariabel. Gateway-tjenestekontoen får ikke tilgang til variabler med brukeromfang, så angis TNS_ADMIN i systemområdet (maskin) og starter deretter den lokale datagatewaytjenesten på nytt.

Den innebygde driveren støtter ikke Oracle proxy-brukergodkjenning. Hvis du vil ha mer informasjon og midlertidige løsninger, kan du se Oracle proxy-brukergodkjenning støttes ikke.

Støttede måter å spesifisere TNS_ADMIN med den innebygde Oracle-driveren

Det finnes tre alternativer for å spesifisere TNS_ADMIN:

Konfigurer TNS_ADMIN i ODAC.config

Hvis du bruker den innebygde Oracle-driveren og har tilgang til å endre programfiler, kan du spesifisere TNS_ADMIN i konfigurasjonsfilen ODAC.config brukes av den innebygde Oracle-driveren. Filen ligger i Power BI Desktop eller den lokale datagateway-installasjonen under undermappen "ADO.NET Providers". Følgende er et eksempel på å spesifisere TNS_ADMIN sti som er "C:\network\admin".

Denne konfigurasjonsverdien har forrang over andre alternativer.

Eksempelkonfigurasjon

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

Merk at TNS_ADMIN konfigurert i ODAC.config har forrang over en TNS_ADMIN innstilling i miljøet.

Bruk en miljøvariabel

Hvis brukeren ikke har tilgang til å endre ODAC.config, kan de spesifisere TNS_ADMIN ved å legge til en TNS_ADMIN miljøvariabel. Miljøvariabelen kan være en systemmiljøvariabel eller en brukermiljøvariabel for brukeren som kjører Power BI Desktop eller den lokale datagatewayen. Sett TNS_ADMIN-verdien til "C:\network\admin", for eksempel.

Å sette TNS_ADMIN i miljøet (spesielt på systemnivå) kan føre til at andre applikasjoner som kjører på denne maskinen plukker opp nettverkskonfigurasjonsfilene (som tnsnames.ora) fra stedet som TNS_ADMIN peker til.

Bruk innstillinger fra en tidligere installert ODAC

Hvis ODAC er installert tidligere og TNS_ADMIN er konfigurert, vil Power BI automatisk oppdage TNS_ADMIN.

De gjenværende konfigurasjonene for å koble til en Oracle-database fra Power Query Desktop er de samme som beskrevet i de forrige delene.

Liste over tillatte eiendommer

Brukere kan spesifisere Oracle-servernavn ved å bruke tilkoblingsbeskrivelser som (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name))). Systemet håndhever hvilke egenskaper som kan brukes i Desktop og Gateway. De standard tillatede egenskapene i ODAC.config er listet i følgende seksjon.

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

Brukere kan endre denne tillatte egenskapslisten hvis de trenger å legge til nye egenskaper eller fjerne egenskaper fra listen for å håndheve strengere regler.

Merk deg

Viktige begrensninger

  • Bruk av den innebygde Oracle-administrerte ODP.NET driveren for DirectQuery er i forhåndsversjon. Hvis du vil ha mer informasjon, kan du se de foregående DirectQuery-inndelingene.
  • Filen ODAC.config kan kreve administratorrettigheter for å redigere, og Power BI Store-appen tillater ikke endring av denne filen.
  • Endringene som gjøres i ODAC.config overskrives under oppgraderingen, og du må lagre filen på en annen plassering før oppgraderingen.
  • For at On-Premises Data Gateway skal fungere riktig, må du sørge for at brukeren som gateway-tjenesten kjører under har tilgang til mappen som TNS_ADMIN peker på.
  • Start Power BI Desktop eller On-premises Data Gateway-tjenesten på nytt etter å ha gjort konfigurasjonsendringer.

Begrensninger og hensyn

Power BI-økter kan fortsatt være aktive i Oracle-databasen i omtrent 30 minutter etter at en semantisk modell oppdateres til Oracle-databasen. Først etter omtrent 30 minutter blir disse øktene inaktive/fjernet i Oracle-databasen. Denne virkemåten er i henhold til utformingen.

Feilsøking

Du kan komme over flere feil fra Oracle når navnesyntaksen enten er feil eller ikke riktig konfigurert:

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

Disse feilene kan oppstå hvis Oracle tnsnames.ora-databasetilkoblingsbeskrivelsen er feilkonfigurert, det angitte nettjenestenavnet er feilstavet, eller Oracle-databaselytteobjektet kjører ikke eller kan ikke nås, for eksempel en brannmur som blokkerer lytteren eller databaseporten. Pass på at du oppfyller minimumskravene for installasjon. Mer informasjon: Forhåndskrav

Gå til hjelpeportalen for Oracle-databasefeil for å se gjennom vanlige årsaker og løsninger for den bestemte Oracle-feilen du støter på. Skriv inn Oracle-feilen i portalsøkefeltet.

Når du bruker DirectQuery gjennom den lokale datagatewayen med den innebygde Oracle-driveren, kan feil som følgende indikere at et TNS-alias ikke kan løses:

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

Hvis du støter på disse feilene, må du kontrollere at TNS_ADMIN det er angitt i systemområdet (maskin) og at gateway-tjenestekontoen kan få tilgang til mappen den peker til, og deretter starte den lokale datagatewaytjenesten på nytt. Hvis du vil ha mer informasjon, kan du se Støttede måter å angi TNS_ADMIN med den innebygde Oracle-driveren og Oracles veiledning for feilsøking av Oracle Net Services .

Kjente problemer med den innebygde Oracle-driveren

Følgende kjente problemer er spesifikke for den innebygde Oracle-administrerte ODP.NET driveren. Flere av løsningene faller tilbake til ODP.NET uadministrert driver ved å slå av den innebygde driveren. Se Bruke den innebygde Oracle-driveren for å slå av trinnene for hver overflate – Power BI Desktop Import og DirectQuery, og gatewayimport og DirectQuery.

TNS-aliaser på en delt nettverksressurs er ikke løst

Gjelder for den lokale datagatewayen, både i Import og DirectQuery.

Når Oracle-nettverkskonfigurasjonsfilene (tnsnames.ora eller katalogen TNS_ADMIN ) er lagret på en delt nettverksressurs (UNC-bane), kan ikke den innebygde driveren konsekvent løse nettjenestenavnet (TNS-aliaset). Det kan hende du ser ORA-12154: TNS:could not resolve the connect identifier specified eller ORA-50201: Failed to connect to server. Det samme aliaset løses på riktig måte med ODP.NET uadministrert driver, eller når filene er på en lokal bane. Den innebygde administrerte driveren leser ikke Oracle-nettverkskonfigurasjonsfiler på en pålitelig måte fra en UNC-plassering.

Bruk én av følgende løsninger:

  • Kopier tnsnames.ora (og sqlnet.ora hvis du bruker den) til en mappe på en lokal stasjon, og pek deretter driveren på mappen. Se støttede måter å angi TNS_ADMIN med den innebygde Oracle-driveren på. Angi systemområdet (maskin) for gatewayen DirectQuery TNS_ADMIN fordi gateway-tjenestekontoen ikke kan lese variabler med brukeromfang, og start gateway-tjenesten på nytt.
  • Kontroller at tjenestekontoen som kjører gatewayen, har tilgang til den delte nettverksressursen.
  • Skriv inn en Easy Connect-beskrivelse direkte i Server (for eksempel host:port/service_name) i stedet for et tnsnames.ora alias, slik at ingen nettverkskonfigurasjonsfil er nødvendig.
  • Slå av den innebygde driveren for å gå tilbake til ODP.NET uadministrert driver, som kan lese filene fra den delte ressursen.

NLS_LANG ignoreres

Gjelder for Power BI Desktop, den lokale datagatewayen og Power Bi-tjeneste skytilkoblinger, både i Import og DirectQuery.

Med den innebygde driveren følger Oracle-øktspråk, distrikt og tall- og datoformater maskinens .NET kultur (Windows regionale innstillinger og formatinnstillinger), ikke miljøvariabelenNLS_LANG. Innstilling eller endring NLS_LANG har ingen effekt. Avhengig av maskinens område kan denne virkemåten føre til at tall eller datoer analyseres med feil skilletegn eller datorekkefølge, spørringer for å returnere null rader eller uriktige verdier, eller feil, for eksempel ORA-01722, ORA-01858, ORA-01861eller ORA-01843. En rapport som er skrevet på en maskin som er satt til engelsk (USA), kan for eksempel returnere null rader eller feil på en maskin som er satt til engelsk (Storbritannia). Den administrerte ODP.NET-driveren henter innstillingene for nasjonal språkstøtte (NLS) fra .NET trådkultur i stedet for fra NLS_LANG, i motsetning til ODP.NET uadministrert driver, som hedrer NLS_LANG.

Bruk én av følgende løsninger:

  • Samsvar med maskinens regionale innstillinger med den nasjonale innstillingen som dataene og spørringene ble utformet for.
  • Slå av den innebygde driveren for å falle tilbake til ODP.NET uadministrert driver, som hedrer NLS_LANG.

Hvis du vil ha bakgrunn om den administrerte driverens globaliseringsvirkemåte, kan du se dokumentasjonen for Globaliseringsstøtte for Oracle.

FetchSize i registeret brukes ikke av den innebygde driveren

Gjelder for Power BI Desktop og den lokale datagatewayen for Oracle Import-modeller.

Når du bytter til den innebygde driveren, kan Oracle Import-modeller oppdateres saktere enn med ODP.NET uadministrert driver. Den innebygde administrerte ODP.NET leverandøren leser FetchSize ikke egenskapen fra registeret. Standarden FetchSize for ODP.NET uadministrerte og administrerte leverandører er 128 kB i versjon 23.26.2 og tidligere, inkludert 23.6-leverandøren som Power BI inkluderer. Den administrerte leverandøren ignorerer eventuelle FetchSize overstyringer som er konfigurert i registeret.

Slå av den innebygde driveren for å falle tilbake til ODP.NET uadministrert driver, som respekterer registerinnstillingenFetchSize. I den lokale datagatewayen, satt MashupFlight_DisableOracleBundledOdacProviderV2 til True i konfigurasjonen av den buntede leverandøren i gateway-innstillinger.

Oracle proxy-brukergodkjenning støttes ikke

Gjelder for den lokale datagatewayen (juni 2026 versjon og nyere), for Oracle Import og DirectQuery som bruker en Oracle-proxy-konto.

Når du har oppgradert til gatewayen for juni 2026, som er standard for den innebygde administrerte leverandøren, Power BI rapporter som kobler til Oracle ved hjelp av en Oracle-proxy-konto, mislykkes i både Import og DirectQuery. Den samme datakilden fungerer når tilkoblingen bruker en Oracle-konto som ikke er proxy. Proxy-brukergodkjenning for Oracle Database – som kobles til som én databasebruker på vegne av et annet skjema (for eksempel User Id=proxy_user[target_schema] skjemaet)– støttes ikke av versjon 23.6 av den innebygde administrerte ODP.NET leverandøren som for øyeblikket leveres med Power BI.

Bruk én av følgende løsninger:

  • Bruk en Oracle-konto som ikke er proxy der det er mulig.
  • Når det gjelder import, deaktiverer du den innebygde driveren for import på gatewayen ved å angi MashupFlight_DisableOracleBundledOdacProviderV2 til True, slik at gatewayen faller tilbake til ODP.NET uadministrert driver, som støtter proxy-kontoer.
  • Importinnstillingen gjelder ikke for DirectQuery. Kontakt Microsoft Kundestøtte for å deaktivere den innebygde driveren for Gateway DirectQuery-banen. Denne konfigurasjonen er ikke selvbetjent i dag.

Kan ikke oppdatere oracle personlig skytilkoblingslegitimasjon

Gjelder for Power Bi-tjeneste, for Oracle personlige skytilkoblinger.

siden Behandle tilkoblinger og gatewayer i Power Bi-tjeneste fungerer ikke oppdatering av legitimasjonen for en personlig Oracle-skytilkobling. Oppdater i stedet legitimasjonen fra ruten for semantiske modellinnstillinger:

  1. Åpne ruten for semantiske modellinnstillinger , og gå til Gateway- og skytilkoblinger.
  2. Angi datakilden til å bruke den personlige skytilkoblingen.
  3. Rediger legitimasjonen for datakilden under Legitimasjon for datakilde.

Hvis du lastet ned Power BI Desktop fra Microsoft Store, kan det hende du ikke kan koble til Oracle-databaser på grunn av et Oracle-driverproblem. Hvis du støter på dette problemet, er feilmeldingen som returneres: Objektreferanse ikke angitt. Du kan løse problemet ved å laste ned Power BI Desktop fra Download Center i stedet for Microsoft Store.

Hvis objektreferansen ikke angir en feilmelding i Power BI når du kobler til en Oracle-database ved hjelp av den lokale datagatewayen, følger du instruksjonene i Behandle datakilden – Oracle.

Hvis du bruker rapportserver for Power BI, kan du se veiledningen i artikkelen Oracle Connection Type .

Optimaliser Power Query når du utvider tabellkolonner