Databáze Oracle

Shrnutí

Property Value
Connector Ikona databáze Oracle Databáze Oracle
Produkty Vynikat
Power BI (sémantické modely)
Power Query Online
Stav vydání Obecná dostupnost
Typy ověřování Windows (počítačová verze / online)
Databáze (desktopová verze)
Základní (online)
Účet Microsoft (desktop)
Druh zdroje dat Oracle
Referenční dokumentace k funkcím Oracle.Database

Poznámka:

Některé funkce můžou být přítomné v jednom produktu, ale ne v jiných kvůli plánům nasazení a možnostem specifickým pro jednotlivé hostitele.

Požadavky

Podporované verze Oracle:

  • Oracle Database Server 12c (12.1.0.2) a novější
  • Oracle Autonomous Database – všechny verze

Od verze Power BI Desktopu z dubna 2025 a místní brány dat z května 2025 můžete k připojení k databázi Oracle použít integrovaný ovladač ODP.NET spravovaný oraclem. Když tuto funkci povolíte, nemusíte nástroj OCMT instalovat ručně. Od června 2026 můžete také vytvořit cloudové připojení k Oracle Autonomous Database nebo jiným koncovým bodům cloudu Oracle bez brány. Přečtěte si další informace o této funkci.

Pokud nepoužíváte nový integrovaný ovladač Oracle, musíte použít podnikovou místní bránu dat a nainstalovat 64bitového klienta Oracle for Microsoft Tools (OCMT) na počítač, na kterém běží brána nebo Power BI Desktop. Další informace najdete v tématu Správa zdroje dat – Oracle.

Podporované funkce

  • Dovoz
  • DirectQuery (sémantické modely Power BI)
  • Pokročilé možnosti
    • Časový limit příkazu v minutách
    • Příkaz SQL
    • Zahrnout sloupce vztahů
    • Navigovat pomocí celé hierarchie

Připojení z Power Query Desktopu

Místní databáze

Pokud chcete vytvořit připojení, proveďte následující kroky:

  1. Ve výběru konektoru vyberte možnost databáze Oracle .

  2. Zadejte název služby Oracle net nebo alias TNS nebo připojovací řetězec Easy Connect (Plus) pro připojení k serveru. Snadné připojení je nejjednodušší použít nastavením hodnoty Server na název hostitele serveru Oracle Database /ServiceName, kde ServiceName je globální název databáze. Následující snímek obrazovky používá název síťové služby.

    Snímek obrazovky s dialogovým oknem připojení k databázi Oracle, kde zadáte informace o připojení k databázi Oracle

  3. Pokud se připojujete z Power BI Desktopu, vyberte režim připojení k datům buď Import nebo DirectQuery. Zbývající z těchto ukázkových kroků používají režim připojení k importu dat. Další informace o DirectQuery najdete v tématu Použití DirectQuery v Power BI Desktopu.

  4. Pokud se k této databázi Oracle připojujete poprvé, vyberte typ ověřování, který chcete použít, a zadejte svoje přihlašovací údaje. Dostupné typy ověřování jsou:

    • Windows (ověřování systému Windows)
    • Databáze (uživatelské jméno a heslo)
    • Účet Microsoft (Microsoft Entra ID)

    Další informace o ověřování najdete v tématu Ověřování pomocí zdroje dat.

    Snímek obrazovky s dialogovým oknem ověřování, kde zadáte přihlašovací údaje k databázi Oracle

  5. Ve navigátoruvyberte data, která potřebujete, a poté vyberte Načíst pro načtení dat nebo Transformovat data pro transformaci dat.

Připojení z Power Query Online

Místní databáze

Pokud chcete vytvořit připojení, proveďte následující kroky:

  1. Nainstalujte a nastavte místní bránu dat.

  2. V Power Query Online vyberte ve výběru zdrojů dat možnost Databáze Oracle .

  3. V dialogovém okně databáze Oracle, které se zobrazí, zadejte název služby Oracle net nebo alias TNS, připojovací řetězec Easy Connect Plus nebo popisovač připojení pro připojení k serveru.

    Snímek obrazovky s oknem databáze Oracle, kde zadáte informace o online připojení k databázi Oracle

  4. Zadejte název připojení, například testoracleserver.

  5. Vyberte název místní brány dat.

  6. Pokud se k této databázi Oracle připojujete poprvé, vyberte typ přihlašovacích údajů pro připojení v typu ověřování. Zvolte Základní , pokud se chcete přihlásit pomocí uživatelského jména a hesla Oracle. Zvolte Windows při ověřování operačního systému Windows a s klientem Oracle i serverem spuštěným ve Windows.

  7. Zadejte svoje přihlašovací údaje.

  8. Pokračujte výběrem tlačítka Další.

  9. V Navigátoru vyberte data, která potřebujete, a pak zvolte Transformovat data, abyste je transformovali v editoru Power Query.

Další informace

Možnost Použití klienta Oracle pro nástroje Microsoft (OCMT)

Klient Oracle for Microsoft Tools nainstaluje a nakonfiguruje zprostředkovatele dat Oracle pro .NET (ODP.NET), aby podporoval 32bitová a 64bitová připojení nástrojů Microsoftu s místními a cloudovými databázemi Oracle, včetně Oracle Autonomous Database (ADB). OCMT je grafický instalační program, který automatizuje proces instalace klienta Oracle Database. Podporuje připojení pomocí Power BI Desktopu, služby Power BI, Fabric (Dataflow Gen2), Excelu, SLUŽBY Analytické služby SQL Serveru, SQL Server Data Tools, Služby Integrace SQL Serveru, SQL Server Reporting Services a BizTalk Serveru.

OCMT je bezplatný software. Můžete si ho stáhnout ze stránky Klienta Oracle for Microsoft Tools. Pro 64bitovou verzi Power BI Desktopu a služby Power BI použijte 64bitovou verzi OCMT. Pro 32bitovou verzi Power BI Desktopu použijte 32bitovou verzi OCMT.

I když už máte na klientovi Power BI nainstalovaný klient Oracle nebo ODP.NET, důrazně doporučujeme použít instalační program OCMT k správnému dokončení všech kroků konfigurace, které Power BI vyžaduje pro práci s databází Oracle.

Připojení k autonomní databázi Oracle

Poznámka:

V současné době se můžete připojit k autonomní databázi Oracle z Excelu, Power BI Desktopu, služby Power BI, Fabric (Dataflow Gen2), Power Apps, Analytické služby SQL Serveru a BizTalk Serveru pomocí postupů v této části. Tyto nástroje používají pro připojení nespravované ODP.NET. Další nástroje Microsoftu, včetně SQL Server Data Tools, Služby Integrace SQL Serveru a SQL Server Reporting Services, používají spravované ODP.NET pro připojení k Oracle Autonomous Database víceméně stejnými postupy.

Pokud chcete připojit Power BI k autonomní databázi Oracle, potřebujete následující účty a aplikace:

Stažení přihlašovacích údajů klienta

Prvním krokem při nastavování připojení k autonomní databázi Oracle je stažení přihlašovacích údajů klienta.

Stažení přihlašovacích údajů klienta:

  1. Na stránce podrobností o autonomní databázi Oracle vyberte připojení k databázi.

    Snímek obrazovky se stránkou Výsledky autonomní databáze se zvýrazněnou možností Připojení k databázi

  2. Na stránce Připojení k databázi vyberte Stáhnout peněženku.

    Snímek obrazovky se stránkou Připojení k databázi se zvýrazněnou možností Stáhnout peněženku

  3. Zadejte heslo, které chcete použít s touto peněženkou, potvrďte heslo a pak vyberte Stáhnout.

    Snímek obrazovky se stránkou Stáhnout peněženku, kde zadáte heslo peněženky

Konfigurace přihlašovacích údajů Oracle ADB

  1. Na počítači s Windows přejděte do složky, do které jste stáhli přihlašovací údaje Oracle ADB z části Stažení přihlašovacích údajů klienta.

  2. Rozbalte přihlašovací údaje do adresáře, který jste zadali v OCMT jako adresář konfiguračního souboru Oracle. V tomto příkladu se přihlašovací údaje extrahují do složky c:\data\wallet\wallet_contosomart.

    Snímek obrazovky se soubory peněženky rozbalené ve složce peněženky

    Poznámka:

    Soubor tnsnames.ora definuje adresu a informace o připojení k Oracle Autonomous Database.

  3. Otevřete sqlnet.ora v editoru, například v Poznámkovém bloku.

  4. Pod WALLET_LOCATION změňte cestu ke složce peněženky v možnosti Adresář. V tomto příkladu:

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

  5. Uložte a zavřete soubor sqlnet.ora.

Ve složce peněženky otevřete soubor tnsnames.ora. Soubor obsahuje seznam názvů net služeb ADB, ke kterým se můžete připojit. V tomto příkladu jsou názvy contosomart_high, contosomart_low a contosomart_medium. Názvy vašich síťových služeb ADB se liší.

Snímek obrazovky se třemi příklady názvů TNS, contosomart_high, contosomart_low a contosomart_medium

Připojení Power BI Desktopu k Oracle ADB

  1. Otevřete Power BI Desktop.

  2. Vyberte Načíst data.

  3. V nabídce Získat Data vyberte Databázi>Oracle.

  4. Zadejte název net service serveru Oracle Autonomous Database, ke kterému se chcete připojit. V tomto příkladu je server contosomart_high. Pak vyberte OK.

    Snímek obrazovky dialogového okna databáze Oracle s názvem serveru contosomart_high a vybraným režimem importu.

  5. Pokud se k tomuto serveru přihlašujete z Power BI Desktopu poprvé, zobrazí se výzva k zadání přihlašovacích údajů. Vyberte Databázi a zadejte uživatelské jméno a heslo pro databázi Oracle. Zadané přihlašovací údaje jsou uživatelské jméno a heslo pro konkrétní autonomní databázi Oracle, ke které se chcete připojit. V tomto příkladu se použije počáteční uživatelské jméno a heslo správce databáze. Pak vyberte Připojit.

    Snímek obrazovky s dialogovým oknem Přihlašovací údaje s vybranou databází a zadaným výchozím uživatelským jménem a heslem databáze

    Poznámka:

    Ověřování Microsoft Entra ID můžete použít k přihlášení k Oracle Autonomous Database prostřednictvím možnosti účtu Microsoft .

V tomto okamžiku se zobrazí Navigátor a zobrazí data připojení.

Snímek obrazovky s navigátorem s otevřenou databází contosomart_high

Můžete také narazit na jednu z několika chyb, protože konfigurace není správně nastavená. Tyto chyby jsou popsány v řešení potíží.

Jedna chyba, ke které může dojít v tomto počátečním testu, probíhá v Navigátoru, kde se zdá, že je databáze připojená, ale neobsahuje žádná data. Místo toho se místo dat zobrazí Oracle: ORA-28759: Chyba otevření souboru.

Snímek obrazovky s navigátorem s názvem databáze v horní části, ale místo dat se zobrazí chyba.

Pokud k této chybě dojde, ujistěte se, že cesta ke složce peněženky, kterou jste zadali v sqlnet.ora, je úplná a správná cesta ke složce peněženky.

Rozšířené možnosti

Power Query Desktop a Power Query Online poskytují sadu rozšířených možností, které můžete v případě potřeby přidat do dotazu.

Následující tabulka uvádí všechny pokročilé možnosti, které můžete nastavit v Power Query Desktopu a Power Query Online.

Pokročilá možnost Popis
Časový limit příkazu v minutách Pokud připojení trvá déle než 10 minut (výchozí časový limit), můžete zadat další hodnotu v minutách, aby bylo připojení otevřené déle. Tato možnost je dostupná jenom v Power Query Desktopu.
Příkaz SQL Informace najdete v tématu Import dat z databáze pomocí nativního databázového dotazu.
Zahrnout sloupce vztahů Pokud je tato možnost zaškrtnutá, obsahuje sloupce, které můžou mít relace s jinými tabulkami. Pokud je toto pole nezaškrtnuto, tyto sloupce se nezobrazí.
Navigovat pomocí celé hierarchie Pokud je tato možnost zaškrtnutá, navigátor zobrazí úplnou hierarchii tabulek v databázi, ke které se připojujete. Pokud se vymaže filtr, zobrazí se v navigátoru jenom tabulky, jejichž sloupce a řádky obsahují data.

Jakmile vyberete požadované upřesňující možnosti, vyberte OK v aplikaci Power Query Desktop nebo Další v Power Query Online, abyste se připojili k databázi Oracle.

Použití integrovaného ovladače Oracle

Pro režim importu v Power BI Desktopu

Ve verzi Power BI Desktopu nebo místní brány dat z června 2026 se ve výchozím nastavení pro připojení používá integrovaný spravovaný ovladač Oracle ODP.NET. Tato funkce eliminuje nutnost, aby uživatelé nainstalovali a spravlili ovladač. K odhlášení z této funkce můžete použít následující pokyny.

Pokud nechcete používat tento integrovaný ovladač v Power BI Desktop, přejděte na Možnosti a nastavení (na kartě Soubor) >Možnosti>Funkce ve verzi Preview a potom zrušte zaškrtnutí políčka pro možnost Povolit použití přibaleného zprostředkovatele Oracle Managed ODP Provider pro režim importu.

Snímek obrazovky s možností povolení používání zprostředkovatele Oracle Managed ODP v Power BI Desktopu

Režim DirectQuery v Power BI Desktopu (Preview)

V režimu DirectQuery je použití integrovaného spravovaného ovladače ODP.NET pro Oracle stále ve fázi Preview. Pokud se chcete přihlásit, postupujte podle následujících pokynů.

Pokud chcete použít tento integrovaný ovladač v Power BI Desktop, přejděte na Možnosti a nastavení (na kartě Soubor) >Možnosti>Preview funkce a potom zrušte zaškrtnutí políčka u možnosti Povolit použití přibaleného poskytovatele Oracle Managed ODP pro režim DirectQuery.

Pro režim importu v místní bráně

Od verze z června 2026 používá místní brána dat integrovaný ovladač ORACLE managed ODP.NET pro připojení ve výchozím nastavení. Pokud tento integrovaný ovladač nechcete používat v místní bráně dat pro režim Import, změňte konfiguraci brány tak, abyste podle následujících kroků aktualizovali nastavení MashupFlight_DisableOracleBundledOdacProviderV2.

  1. Na místním počítači, na kterém je nainstalovaná místní brána dat, přejděte na C:\Program Files\Místní brána dat.
  2. Vytvořte zálohu konfiguračního souboru s názvem Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
  3. Otevřete původní konfigurační soubor Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config a vyhledejte položku MashupFlight_DisableOracleBundledOdacProviderV2.
  4. Aktualizujte hodnotu MashupFlight_DisableOracleBundledOdacProviderV2 na True.
  5. Restartujte bránu.
<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_DisableOracleBundledOdacProviderV2" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>    

Poznámka:

Jakmile změníte MashupFlight_DisableOracleBundledOdacProviderV2 nastavení v souboru Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, konfigurace se zachová i po upgradu místní brány dat.

Poznámka:

Pokud vaše sémantické modely stále používají osobní bránu pro připojení k místním zdrojům dat Oracle, upgradujte na podnikovou místní bránu dat nebo bránu virtuální sítě nebo přesunujte cloudové úlohy Oracle na přímé cloudové připojení. Aktualizovaný konektor Oracle nepodporuje osobní místní brány dat. To platí jak pro režim importu, tak režim DirectQuery. Stávající sémantické modely můžou dál používat osobní bránu, dokud neaktualizujete vazbu datového připojení. Po aktualizaci propojení se nemůžete vrátit k osobní bráně. Odpovídajícím způsobem naplánujte upgrady připojení Oracle.

Pro režim DirectQuery v místní bráně (Preview)

Místní brána dat může používat integrovaný ovladač ODP.NET spravovaný oraclem pro DirectQuery. Tato funkce je ve verzi Preview.

Pokud chcete pro DirectQuery vyřešit alias TNS, použijte proměnnou prostředí. Účet služby brány nemá přístup k uživatelským proměnným, takže nastavte TNS_ADMIN v rozsahu systému (počítače) a potom restartujte službu místní brány dat.

Integrovaný ovladač nepodporuje ověřování uživatele proxy serveru Oracle. Další informace a alternativní řešení najdete v tématu Ověřování proxy uživatelů Oracle se nepodporuje.

Podporované způsoby určení TNS_ADMIN pomocí integrovaného ovladače Oracle

Existují tři možnosti, jak zadat TNS_ADMIN:

Konfigurujte TNS_ADMIN v ODAC.config

Pokud používáte integrovaný ovladač Oracle a máte přístup k úpravě programových souborů, můžete zadat TNS_ADMIN v konfiguračním souboru ODAC.config používaný integrovaným ovladačem Oracle. Soubor se nachází buď v Power BI Desktop, nebo v místě, kde je nainstalována místní datová brána, v podsložce "Poskytovatelé ADO.NET". Následuje příklad zadání cesty TNS_ADMIN, která je C:\network\admin.

Tato hodnota konfigurace má přednost před jinými možnostmi.

Příklad konfigurace

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

Všimněte si, že TNS_ADMIN nakonfigurované v ODAC.config má přednost před nastavením TNS_ADMIN v prostředí.

Použití proměnné prostředí

Pokud uživatel nemá přístup k úpravě ODAC.config, může zadat TNS_ADMIN přidáním proměnné prostředí TNS_ADMIN. Proměnnou prostředí může být systémová proměnná prostředí nebo proměnná uživatelského prostředí pro uživatele, který používá Power BI Desktop nebo místní bránu dat. Nastavte hodnotu TNS_ADMIN na "C:\network\admin", například.

Nastavení TNS_ADMIN v prostředí (zejména na úrovni systému) může způsobit, že ostatní aplikace spuštěné na tomto počítači vyberou konfigurační soubory sítě (například tnsnames.ora) z umístění, na které odkazuje TNS_ADMIN.

Použít nastavení z dříve nainstalovaného ODAC

Pokud je funkce ODAC nainstalovaná dříve a TNS_ADMIN je nakonfigurovaná, Power BI automaticky zjistí TNS_ADMIN.

Zbývající konfigurace pro připojení k databázi Oracle z Power Query Desktopu jsou stejné jako v předchozích částech.

Seznam povolených vlastností

Uživatelé mohou zadat názvy serverů Oracle pomocí popisovačů připojení, například (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name))). Systém vynucuje, které vlastnosti je možné použít v Desktopu a bráně. Výchozí povolené vlastnosti v ODAC.config jsou uvedeny v následující části.

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

Uživatelé mohou tento seznam povolených vlastností upravit, pokud potřebují přidat nové vlastnosti nebo odebrat vlastnosti ze seznamu, aby bylo možné vynutit přísnější pravidla.

Poznámka:

Důležitá omezení

  • Použití integrovaného spravovaného ovladače Oracle ODP.NET pro DirectQuery je ve verzi předběžného náhledu. Další informace najdete v předchozích částech DirectQuery.
  • Soubor ODAC.config může vyžadovat oprávnění správce k úpravám a aplikace Power BI Store neumožňuje úpravy tohoto souboru.
  • Změny provedené v ODAC.config se při upgradu přepíšou a před upgradem je nutné soubor uložit do jiného umístění.
  • Aby místní brána dat fungovala správně, ujistěte se, že uživatel, pod kterým je služba brány spuštěná, má přístup ke složce, na kterou odkazuje TNS_ADMIN.
  • Po použití změn konfigurace restartujte Power BI Desktop nebo službu místní brány dat.

Omezení a úvahy

Relace Power BI můžou být ve vaší databázi Oracle aktivní přibližně 30 minut po aktualizaci sémantického modelu na tuto databázi Oracle. Až po přibližně 30 minutách jsou tyto relace z databáze Oracle neaktivní nebo odebrány. Toto chování je záměrné.

Řešení problémů

Pokud je syntaxe pojmenování nesprávná nebo nenakonfigurovaná správně, můžete z Oracle narazit na některou z několika chyb:

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

K těmto chybám může dojít v případě, že popisovač připojení k databázi Oracle tnsnames.ora je chybně nakonfigurovaný, zadaný název síťové služby je chybný nebo naslouchací proces databáze Oracle není spuštěný nebo není dostupný, například brána firewall blokuje naslouchací proces nebo databázový port. Ujistěte se, že splňujete minimální požadavky na instalaci. Další informace: Předpoklady

Navštivte portál nápovědy k chybě databáze Oracle a projděte si běžné příčiny a řešení konkrétní chyby Oracle, se kterou narazíte. Do vyhledávacího pole na portálu zadejte svou chybu Oracle.

Při použití DirectQuery prostřednictvím místní brány dat s integrovaným ovladačem Oracle můžou chyby, jako je následující, znamenat, že alias TNS se nedá vyřešit:

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

Pokud narazíte na tyto chyby, ověřte, že TNS_ADMIN je nastavený v oboru systému (počítače) a že účet služby brány má přístup ke složce, na kterou odkazuje, a restartujte službu místní brány dat. Další informace najdete v tématu Podporované způsoby určení TNS_ADMIN pomocí integrovaného ovladače Oracle a průvodce odstraňováním potíží s Oracle Net Services společnosti Oracle .

Známé problémy s integrovaným ovladačem Oracle

Následující známé problémy jsou specifické pro integrovaný ovladač ODP.NET spravovaný oraclem. Některá z alternativních řešení přejdou na nespravovaný ovladač ODP.NET tím, že vypnou integrovaný ovladač. Postup vypnutí pro jednotlivá prostředí – import a DirectQuery v Power BI Desktopu a import a DirectQuery přes bránu – najdete v tématu Použití integrovaného ovladače Oracle.

Aliasy TNS v síťovém sdílení se nerozpoznají

Platí pro místní bránu dat v importu i DirectQuery.

Pokud jsou konfigurační soubory sítě Oracle (tnsnames.ora nebo v adresáři TNS_ADMIN) uloženy na síťovém sdílení (cesta UNC), integrovaný ovladač opakovaně nedokáže přeložit název síťové služby (alias TNS). Může se zobrazit ORA-12154: TNS:could not resolve the connect identifier specified nebo ORA-50201: Failed to connect to server. Stejný alias se správně vyřeší pomocí nespravovaného ovladače ODP.NET nebo když jsou soubory v místní cestě. Integrovaný spravovaný ovladač nedokáže spolehlivě číst konfigurační soubory sítě Oracle z umístění UNC.

Použijte jedno z následujících alternativních řešení:

  • Zkopírujte tnsnames.ora (a sqlnet.ora pokud ho použijete) do složky na místní jednotce a pak nasměrujte ovladač na tuto složku. Viz Podporované způsoby určení TNS_ADMIN pomocí integrovaného ovladače Oracle. Pro bránu DirectQuery nastavte TNS_ADMIN v oboru systému (počítače), protože účet služby brány nemůže číst proměnné v oboru uživatele, a potom restartujte službu brány.
  • Ujistěte se, že účet služby, na kterém je spuštěná brána, má přístup ke sdílené síťové složce.
  • Místo aliasu zadejte popisovač Easy Connect přímo na Serveru (například host:port/service_name), tnsnames.ora takže není potřeba žádný konfigurační soubor sítě.
  • Vypněte integrovaný ovladač, aby se místo něj použil nespravovaný ovladač ODP.NET, který dokáže číst soubory ze sdílené složky.

NLS_LANG se ignoruje

Platí pro Power BI Desktop, místní bránu pro data a cloudová připojení služby Power BI, a to v režimu Import i DirectQuery.

Při použití integrovaného ovladače se jazyk relace Oracle, územní nastavení a formáty čísel a data řídí kulturou .NET daného počítače (místním a formátovacím nastavením systému Windows), nikoli proměnnou prostředí NLS_LANG. Nastavení nebo změna NLS_LANG nemá žádný vliv. V závislosti na místním nastavení počítače může toto chování způsobit, že se čísla nebo data budou zpracovávat s nesprávnými oddělovači nebo v nesprávném pořadí data, dotazy budou vracet nula řádků nebo nesprávné hodnoty, nebo se vyskytnou chyby, jako jsou ORA-01722, ORA-01858, ORA-01861 nebo ORA-01843. Sestava kopírovaná na počítači nastaveném na angličtinu (USA) může například vracet nulové řádky nebo chyby na počítači nastaveném na angličtinu (Spojené království). Spravovaný ovladač ODP.NET odvozuje nastavení národní jazykové podpory (NLS) z jazykové verze .NET vláken, nikoli z NLS_LANG, na rozdíl od odp.NET nespravovaného ovladače, který respektuje NLS_LANG.

Použijte jedno z následujících alternativních řešení:

  • Porovná místní nastavení počítače s národním prostředím, pro které byla vaše data a dotazy navrženy.
  • Vypněte integrovaný ovladač, aby se použil nespravovaný ovladač ODP.NET, který zohledňuje NLS_LANG.

Základní informace o chování globalizace spravovaného ovladače najdete v dokumentaci k podpoře globalizace Společnosti Oracle.

FetchSize v registru není používán integrovaným ovladačem.

Platí pro Power BI Desktop a místní bránu dat pro modely Import Oracle.

Po přepnutí na integrovaný ovladač se modely Oracle Import můžou aktualizovat pomaleji než pomocí odp.NET nespravovaného ovladače. Vestavěný spravovaný poskytovatel ODP.NET nečte z registru vlastnost FetchSize. Výchozí hodnota FetchSize pro nespravované a spravované poskytovatele ODP.NET je 128 kB ve verzi 23.26.2 a starších, včetně poskytovatele 23.6, který je součástí Power BI. Spravovaný zprostředkovatel ignoruje jakékoli přepsání nastavení FetchSize, které je nakonfigurováno v registru.

Vypněte integrovaný ovladač, aby se použil nespravovaný ovladač ODP.NET, který respektuje nastavení registru FetchSize. V místní bráně dat nastavte v nastavení brány položku MashupFlight_DisableOracleBundledOdacProviderV2 na True v konfiguraci bundled-provider.

Ověřování uživatele proxy serveru Oracle se nepodporuje.

Platí pro místní bránu dat (verze z června 2026 a novější) pro Oracle Import a DirectQuery, které používají účet proxy serveru Oracle.

Po aktualizaci na bránu z června 2026, která je ve výchozím nastavení nastavena na integrovaného spravovaného poskytovatele, sestavy Power BI, které se připojují k Oracle pomocí proxy účtu Oracle, selhávají v režimech Import i DirectQuery. Stejný zdroj dat funguje, když připojení používá účet Oracle bez proxy serveru. Ověřování proxy uživatele v Oracle Database – připojení jako jeden uživatel databáze jménem jiného schématu (například ve tvaru User Id=proxy_user[target_schema]) – není podporováno ve verzi 23.6 integrovaného spravovaného zprostředkovatele ODP.NET, který se aktuálně dodává s Power BI.

Použijte jedno z následujících alternativních řešení:

  • Pokud je to možné, použijte účet Oracle bez proxy serveru.
  • Pro Import vypněte v bráně integrovaný ovladač pro Import nastavením MashupFlight_DisableOracleBundledOdacProviderV2 na True, aby brána přešla zpět na nespravovaný ovladač ODP.NET, který podporuje proxy účty.
  • U DirectQuery se nastavení Import nepoužije. Pokud chcete vypnout integrovaný ovladač pro cestu DirectQuery brány, kontaktujte podpora Microsoftu. Tato konfigurace dnes není samoobslužná.

Nejde aktualizovat přihlašovací údaje pro osobní cloudové připojení Oracle

Platí pro službu Power BI a osobní cloudová připojení k Oracle.

Na stránce Spravovat připojení a brány v služba Power BI nefunguje aktualizace přihlašovacích údajů osobního cloudového připojení Oracle. Místo toho aktualizujte přihlašovací údaje z podokna nastavení sémantického modelu:

  1. Otevřete podokno Nastavení sémantického modelu a přejděte na Brána a cloudová připojení.
  2. Nastavte zdroj dat tak, aby používal osobní cloudové připojení.
  3. V části Přihlašovací údaje ke zdroji dat upravte přihlašovací údaje pro zdroj dat.

Pokud jste stáhli Power BI Desktop z Microsoft Storu, možná se kvůli problému s ovladačem Oracle nemůžete připojit k databázím Oracle. Pokud narazíte na tento problém, vrátí se chybová zpráva: Odkaz na objekt není nastaven. Pokud chcete tento problém vyřešit, stáhněte si Power BI Desktop z webu Download Center místo z Microsoft Storu.

Pokud se v Power BI při připojení k databázi Oracle pomocí místní brány dat zobrazí chybová zpráva Odkaz na objekt nenastaven, postupujte podle pokynů v části Správa zdroje dat – Oracle.

Pokud používáte Server sestav Power BI, přečtěte si pokyny v článku Typ připojení Oracle.

Optimalizace Power Query při rozbalování sloupců tabulky