Oracle Database

Podsumowanie

Przedmiot	Opis
Status wydania	Ogólna dostępność
Produkty	Excel Power BI (modele semantyczne) Power BI (przepływy danych) Sieć szkieletowa (Dataflow Gen2) Power Apps (przepływy danych) Dynamics 365 Customer Insights Analysis Services
Obsługiwane typy uwierzytelniania	Windows (pulpitowy/w trybie online) Baza danych (komputer stacjonarny) Podstawowa (online) Konto Microsoft (komputer)
Dokumentacja referencyjna funkcji	Oracle.Database

Uwaga / Notatka

Niektóre funkcje mogą być obecne w jednym produkcie, ale nie w innych ze względu na harmonogramy wdrażania i możliwości specyficzne dla hosta.

Wymagania wstępne

Obsługiwane wersje oracle:

• Oracle Database Server 12c (12.1.0.2) i nowsze
• Oracle Autonomous Database — wszystkie wersje

Począwszy od wersji programu Power BI Desktop z kwietnia 2025 r. i lokalnej bramy danych z maja 2025 r., możesz użyć wbudowanego sterownika ODP.NET zarządzanego przez firmę Oracle, aby nawiązać połączenie z bazą danych Oracle. Po włączeniu tej funkcji nie trzeba instalować OCMT ręcznie. Począwszy od czerwca 2026 r., można również utworzyć połączenie w chmurze z autonomiczną bazą danych Oracle lub innymi punktami końcowymi chmury Oracle bez bramy. Dowiedz się więcej o tej funkcji.

Jeśli nie używasz nowego wbudowanego sterownika Oracle, musisz użyć lokalnej bramy danych przedsiębiorstwa i zainstalować 64-bitowego klienta Oracle Dla narzędzi Microsoft Tools (OCMT) na komputerze z bramą lub Power BI Desktop. Aby uzyskać więcej informacji, zobacz Zarządzanie źródłem danych — Oracle.

Obsługiwane możliwości

• Importowanie
• DirectQuery (modele semantyczne Power BI)
• Opcje zaawansowane
  • Czas oczekiwania polecenia w minutach
  • Instrukcja SQL
  • Dołącz kolumny relacji
  • Nawigowanie przy użyciu pełnej hierarchii

Opcja Using Oracle Client for Microsoft Tools (OCMT) (Using Oracle Client for Microsoft Tools (OCMT) (Korzystanie z klienta Oracle Dla narzędzi Microsoft Tools (OCMT)

Klient Oracle Client for Microsoft Tools instaluje i konfiguruje dostawcę danych Oracle dla platformy .NET (ODP.NET) w celu obsługi 32-bitowych i 64-bitowych połączeń narzędzi firmy Microsoft z lokalnymi i w chmurze bazami danych Oracle, w tym bazą danych Oracle Autonomous Database (ADB). OCMT to instalator graficzny, który automatyzuje proces instalacji klienta bazy danych Oracle. Obsługuje ona nawiązywanie połączeń z programem Power BI Desktop, usługą Power BI, siecią szkieletową (Dataflow Gen2), Excel, SQL Server Analysis Services, SQL Server Data Tools, SQL Server Integration Services, SQL Server Reporting Services i BizTalk Server Server.

OCMT to bezpłatne oprogramowanie. Można go pobrać ze strony Oracle Client for Microsoft Tools. W przypadku 64-bitowych wersji programu Power BI Desktop i usługi Power BI użyj OCMT w wersji 64-bitowej. W przypadku 32-bitowego programu Power BI Desktop użyj 32-bitowego OCMT.

Nawet jeśli masz już zainstalowanego klienta Oracle lub ODP.NET na kliencie Power BI, zdecydowanie zalecamy użycie instalatora OCMT do prawidłowego wykonania wszystkich kroków konfiguracji, które są wymagane przez usługę Power BI do pracy z bazą danych Oracle.

• Pobieranie OCMT w wersjach 64-bitowej i 32-bitowej
• Instrukcje instalacji i konfiguracji OCMT

Nawiązywanie połączenia z lokalną bazą danych Oracle z programu Power BI Desktop

Aby nawiązać połączenie, wykonaj następujące czynności:

1. Wybierz opcję Baza danych Oracle w wybranym łączniku.

2. Określ nazwę usługi sieciowej Oracle/TNS alias lub ciąg znaków Easy Connect (Plus), aby połączyć się z Serverem. Program Easy Connect jest najprostszy do użycia, ustawiając wartość Serwera na nazwę hosta serwera bazy danych Oracle/nazwę usługi, gdzie ServiceName jest globalną nazwą bazy danych. Poniższy zrzut ekranu używa nazwy usługi sieci.

   

3. Jeśli łączysz się z programem Power BI Desktop, wybierz tryb połączenia danych: Import lub DirectQuery. W pozostałych krokach tego przykładu używany jest tryb łączności danych Import. Aby dowiedzieć się więcej na temat trybu DirectQuery, przejdź do Używanie trybu DirectQuery w programie Power BI Desktop.

4. Jeśli łączysz się z tą bazą danych Oracle po raz pierwszy, wybierz typ uwierzytelniania, którego chcesz użyć, a następnie wprowadź swoje poświadczenia. Dostępne typy uwierzytelniania to:

   • Windows (uwierzytelnianie systemu Windows)
   • Baza danych (nazwa użytkownika i hasło)
   • Konto Microsoft (Microsoft Entra ID)

   Aby uzyskać więcej informacji na temat uwierzytelniania, zobacz Authentication with a data source (Uwierzytelnianie za pomocą źródła danych).

   

5. W Navigatorwybierz wymagane dane, a następnie wybierz pozycję Załaduj, aby załadować dane lub Przekształć dane, aby przekształcić dane.

Nawiązywanie połączenia z lokalną bazą danych Oracle z usługi Power Query Online

Aby nawiązać połączenie, wykonaj następujące czynności:

1. Instalowanie i konfigurowanie lokalnej bramy danych.

2. W usłudze Power Query Online wybierz opcję Baza danych Oracle w wybranych źródłach danych.

3. W oknie dialogowym Baza danych Oracle określ nazwę usługi sieciowej Oracle/alias TNS, łańcuch połączenia Easy Connect Plus lub deskryptor połączenia, aby połączyć się w polu Serwer.

   

4. Podaj nazwę połączenia, taką jak "testoracleserver".

5. Wybierz nazwę lokalnej bramy danych.

6. Jeśli łączysz się z tą bazą danych Oracle po raz pierwszy, wybierz typ poświadczeń dla połączenia w polu Rodzaj uwierzytelniania. Wybierz pozycję Podstawowa , jeśli planujesz zalogować się przy użyciu nazwy użytkownika i hasła oracle. Wybierz system Windows w przypadku korzystania z uwierzytelniania systemu operacyjnego Windows i zarówno klienta Oracle, jak i serwera działającego w systemie Windows.

7. Wprowadź swoje dane logowania.

8. Wybierz przycisk Dalej, aby kontynuować.

9. W nawigatorze wybierz wymagane dane, a następnie wybierz pozycję Przekształć dane, aby przekształcić dane w Edytor Power Query.

Nawiązywanie połączenia z autonomiczną bazą danych Oracle

Uwaga / Notatka

Obecnie możesz nawiązać połączenie z autonomiczną bazą danych Oracle z programu Excel, programu Power BI Desktop, usługi Power BI, sieci szkieletowej (dataflow Gen2), usługi Power Apps, usług SQL Server Analysis Services i programu BizTalk Server, korzystając z procedur opisanych w tej sekcji. Te narzędzia korzystają z niezarządzanego ODP.NET do łączenia się. Inne narzędzia firmy Microsoft, w tym narzędzia SQL Server Data Tools, usługi SQL Server Integration Services i SQL Server Reporting Services, używają zarządzanej biblioteki ODP.NET do łączenia się z autonomiczną bazą danych Oracle przy użyciu w dużej mierze podobnych metod.

Aby połączyć usługę Power BI z autonomiczną bazą danych Oracle, potrzebne są następujące konta i aplikacje:

• Konto Oracle.com (rejestracja konta Oracle.com)
• Konto Oracle Cloud (rejestracja konta Oracle Cloud)
• Autonomiczna baza danych Oracle (uzyskiwanie zawsze bezpłatnej autonomicznej bazy danych)
• Power BI Desktop (Pobierz program Power BI Desktop) lub konto usługi Power BI (licencjonowanie usługi Power BI dla użytkowników w organizacji)

Pobierz poświadczenia klienta

Pierwszym krokiem konfigurowania połączenia z autonomiczną bazą danych Oracle jest pobranie poświadczeń klienta.

Aby pobrać poświadczenia klienta:

1. Na stronie szczegółów autonomicznej bazy danych Oracle wybierz pozycję Połączenie z bazą danych.

   

2. Na stronie Połączenie z bazą danych wybierz pozycję Pobierz portfel.

   

3. Wprowadź hasło, którego chcesz użyć z tym portfelem, potwierdź hasło, a następnie wybierz pozycję Pobierz.

   

Konfigurowanie poświadczeń bazy danych Oracle ADB

1. Na komputerze z systemem Windows przejdź do folderu, w którym pobrano poświadczenia bazy danych Oracle ADB z pozycji Pobierz poświadczenia klienta.

2. Rozpakuj poświadczenia do katalogu określonego w usłudze OCMT jako katalog plików konfiguracji Oracle. W tym przykładzie poświadczenia są wyodrębniane do c:\data\portfel\wallet_contosomart.

   

   Uwaga / Notatka

   Plik tnsnames.ora definiuje adres i informacje o połączeniu z bazą danych Oracle Autonomous Database.

3. Otwórz plik sqlnet.ora w edytorze, takim jak Notatnik.

4. W WALLET_LOCATION zmień ścieżkę do folderu portfela w opcji Katalog. W tym przykładzie:

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

5. Zapisz i zamknij plik sqlnet.ora.

Otwórz plik tnsnames.ora w folderze portfeli. Plik zawiera listę nazw usług sieciowych usługi ADB, z którymi można nawiązać połączenie. W tym przykładzie nazwy są contosomart_high, contosomart_low i contosomart_medium. Nazwy usług sieciowych ADB są różne.

Łączenie programu Power BI Desktop z bazą danych Oracle ADB

1. Otwórz program Power BI Desktop.

2. Wybierz pozycję Pobierz dane.

3. W obszarze Pobierz dane wybierz pozycję Baza danych>.

4. Wprowadź nazwę usługi sieci serwera Oracle Autonomous Database, z którym chcesz nawiązać połączenie. W tym przykładzie serwer jest contosomart_high. Następnie wybierz opcję OK.

   

5. Jeśli logujesz się do tego serwera z programu Power BI Desktop po raz pierwszy, zostanie wyświetlony monit o wprowadzenie poświadczeń. Wybierz pozycję Baza danych, a następnie wprowadź nazwę użytkownika i hasło bazy danych Oracle. Wprowadzone w tym miejscu poświadczenia to nazwa użytkownika i hasło dla konkretnej autonomicznej bazy danych Oracle, z którą chcesz nawiązać połączenie. W tym przykładzie używana jest początkowa nazwa użytkownika i hasło administratora bazy danych. Następnie wybierz pozycję Połącz.

   

   Uwaga / Notatka

   Możesz użyć uwierzytelniania microsoft Entra ID, aby zalogować się do autonomicznej bazy danych Oracle za pośrednictwem opcji konta Microsoft .

W tym momencie zostanie wyświetlony nawigator i wyświetli dane połączenia.

Możesz również napotkać jeden z kilku błędów, ponieważ konfiguracja nie jest prawidłowo skonfigurowana. Te błędy zostały omówione w temacie Rozwiązywanie problemów.

Jeden błąd, który może wystąpić w tym początkowym teście, odbywa się w nawigatorze, gdzie baza danych wydaje się być połączona, ale nie zawiera żadnych danych. Zamiast tego, Oracle: ORA-28759: błąd otwierania pliku pojawia się zamiast danych.

Jeśli wystąpi ten błąd, upewnij się, że ścieżka folderu portfela podana w pliku sqlnet.ora jest pełną i poprawną ścieżką do folderu portfela.

Nawiązywanie połączenia przy użyciu opcji zaawansowanych

Programy Power Query Desktop i Power Query Online udostępniają zestaw zaawansowanych opcji, które można dodać do zapytania w razie potrzeby.

W poniższej tabeli wymieniono wszystkie opcje zaawansowane, które można ustawić w programie Power Query Desktop i dodatku Power Query Online.

Opcja zaawansowana	Opis
Czas oczekiwania polecenia w minutach	Jeśli połączenie trwa dłużej niż 10 minut (domyślny limit czasu), możesz wprowadzić inną wartość w minutach, aby utrzymać połączenie otwarte przez dłuższy czas. Ta opcja jest dostępna tylko w programie Power Query Desktop.
Instrukcja SQL	Aby uzyskać informacje, przejdź do tematu Importowanie danych z bazy danych przy użyciu natywnego zapytania bazy danych.
Dołącz kolumny relacji	Jeśli jest zaznaczone, zawiera kolumny, które mogą mieć relacje z innymi tabelami. Jeśli to pole jest wyczyszczone, te kolumny nie są wyświetlane.
Nawigowanie przy użyciu pełnej hierarchii	Jeśli to pole jest zaznaczone, nawigator wyświetla pełną hierarchię tabel w bazie danych, z którą nawiązujesz połączenie. W przypadku wyczyszczenia nawigator wyświetla tylko tabele, których kolumny i wiersze zawierają dane.

Po wybraniu potrzebnych opcji zaawansowanych wybierz przycisk OK w programie Power Query Desktop lub Dalej w usłudze Power Query Online, aby nawiązać połączenie z bazą danych Oracle.

Korzystanie z wbudowanego sterownika Oracle

Dla trybu importu w programie Power BI Desktop

W przypadku wersji Power BI Desktop lub lokalnej bramy danych z czerwca 2026 r. domyślną wartością jest użycie wbudowanego sterownika ODP.NET zarządzanego przez firmę Oracle na potrzeby łączności. Ta funkcja eliminuje konieczność instalowania sterownika i zarządzania nim przez użytkowników. Nadal możesz zrezygnować z tej funkcji, korzystając z poniższych instrukcji.

Aby nie używać tego wbudowanego sterownika w programie Power BI Desktop, przejdź do Opcje i ustawienia (na karcie Plik) >Opcje>Funkcje w wersji zapoznawczej, a następnie odznacz pole wyboru, aby wyłączyć opcję Włącz użycie dołączonego dostawcy Oracle Managed ODP dla trybu importu.

Dla trybu DirectQuery w Power BI Desktop (wersja zapoznawcza)

W przypadku trybu DirectQuery korzystanie z wbudowanego sterownika ODP.NET zarządzanego przez Oracle nadal jest w wersji zapoznawczej. Aby wyrazić zgodę, skorzystaj z poniższych instrukcji.

Aby użyć tego wbudowanego sterownika w Power BI Desktop, przejdź do Opcje i ustawienia (na karcie Plik) >Opcje>Funkcje w wersji zapoznawczej, a następnie wyczyść pole wyboru opcji Włącz użycie dołączonego zarządzanego dostawcy Oracle ODP dla trybu DirectQuery.

Dla trybu importu w bramie lokalnej

Począwszy od wersji z czerwca 2026 r., lokalna brama danych domyślnie używa wbudowanego sterownika ODP.NET zarządzanego przez firmę Oracle do łączności. Aby nie używać tego wbudowanego sterownika w bramie danych lokalnego środowiska w trybie Import, zmień konfigurację bramy, aby zaktualizować ustawienie MashupFlight_DisableOracleBundledOdacProviderV2, wykonując następujące kroki:

1. Na komputerze lokalnym, na którym zainstalowano lokalną bramę danych, przejdź do C:\Program Files\On-premises data gateway.
2. Utwórz kopię zapasową pliku konfiguracji o nazwie Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
3. Otwórz oryginalny plik konfiguracji Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config i znajdź wpis MashupFlight_DisableOracleBundledOdacProviderV2.
4. MashupFlight_DisableOracleBundledOdacProviderV2 Zaktualizuj wartość na True.
5. Uruchom ponownie bramę.

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

Uwaga / Notatka

Po zmianie MashupFlight_DisableOracleBundledOdacProviderV2 ustawienia w pliku Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config konfiguracja będzie się powtarzać w przypadku uaktualnień lokalnej bramy danych.

Uwaga / Notatka

Jeśli modele semantyczne nadal używają bramy osobistej do łączenia się z lokalnymi źródłami danych Oracle, przeprowadź uaktualnienie do lokalnej bramy danych przedsiębiorstwa lub bramy sieci wirtualnej (VNET) lub przenieś obciążenia Oracle w chmurze na bezpośrednie połączenia w chmurze. Zaktualizowany łącznik Oracle nie obsługuje osobistych lokalnych bram danych. Dotyczy to zarówno trybu importu, jak i trybu DirectQuery. Istniejące modele semantyczne mogą nadal używać bramy osobistej do momentu zaktualizowania powiązania połączenia danych. Po zaktualizowaniu powiązania nie można wrócić do bramy osobistej. Zaplanuj odpowiednie uaktualnienia połączeń Oracle.

Dla trybu DirectQuery w lokalnej bramie danych (wersja zapoznawcza)

Brama danych w środowisku lokalnym może używać wbudowanego sterownika ODP.NET zarządzanego przez firmę Oracle na potrzeby trybu DirectQuery. Ta funkcja jest dostępna w wersji zapoznawczej.

Aby rozwiązać alias TNS dla trybu DirectQuery, użyj zmiennej środowiskowej. Konto usługi bramy nie ma dostępu do zmiennych użytkownika, dlatego ustaw TNS_ADMIN na poziomie systemu (komputera), a następnie uruchom ponownie usługę lokalnej bramy danych.

Wbudowany sterownik nie obsługuje uwierzytelniania użytkownika serwera proxy Oracle. Aby uzyskać więcej informacji i obejść, zobacz Oracle proxy-user authentication nie jest obsługiwane.

Obsługiwane sposoby określania TNS_ADMIN za pomocą wbudowanego sterownika Oracle

Istnieją trzy opcje określania TNS_ADMIN:

• Konfigurowanie TNS_ADMIN w OADC.config
• Używanie zmiennej środowiskowej
• Używanie ustawień z wcześniej zainstalowanej usługi OADC

Konfigurowanie TNS_ADMIN w usłudze ODAC.config

Jeśli używasz wbudowanego sterownika Oracle i masz dostęp do modyfikowania plików programu, możesz określić TNS_ADMIN w pliku konfiguracji ODAC.config używanym przez wbudowany sterownik Oracle. Plik znajduje się w programie Power BI Desktop lub lokalnej bramie danych zainstalowanej w podfolderze "ADO.NET Providers". Poniżej przedstawiono przykład określania ścieżki TNS_ADMIN " C:\network\admin".

Ta wartość konfiguracji ma pierwszeństwo przed innymi opcjami.

Przykładowa konfiguracja

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

Należy pamiętać, że TNS_ADMIN skonfigurowane w ODAC.config ma pierwszeństwo przed ustawieniem TNS_ADMIN w środowisku.

Używanie zmiennej środowiskowej

Jeśli użytkownik nie ma dostępu do modyfikowania ODAC.config, może określić TNS_ADMIN przez dodanie zmiennej środowiskowej TNS_ADMIN. Zmienną środowiskową może być zmienna środowiskowa systemu lub zmienna środowiskowa użytkownika dla użytkownika z uruchomionym programem Power BI Desktop lub lokalną bramą danych. Ustaw wartość TNS_ADMIN na "C:\network\admin", na przykład.

Ustawienie TNS_ADMIN w środowisku (zwłaszcza na poziomie systemu) może spowodować, że inne aplikacje uruchomione na tym komputerze będą pobierać pliki konfiguracji sieci (takie jak tnsnames.ora) z lokalizacji wskazywanej przez TNS_ADMIN.

Użyj ustawień z wcześniej zainstalowanego ODAC

Jeśli funkcja ODAC jest zainstalowana wcześniej i TNS_ADMIN jest skonfigurowana, usługa Power BI automatycznie odnajduje TNS_ADMIN.

Pozostałe konfiguracje łączące się z bazą danych Oracle z programu Power Query Desktop są takie same, jak opisano w poprzednich sekcjach.

Lista dozwolonych właściwości

Użytkownicy mogą określać nazwy serwerów Oracle przy użyciu deskryptorów połączeń, takich jak (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name))). System wymusza, które właściwości mogą być używane w usłudze Desktop i Gateway. Domyślne dozwolone właściwości w ODAC.config wymieniono w poniższej sekcji.

<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żytkownicy mogą modyfikować tę listę dozwolonych właściwości, jeśli muszą dodać nowe właściwości lub usunąć właściwości z listy, aby wymusić bardziej rygorystyczne reguły.

Uwaga / Notatka

Ważne ograniczenia

• Korzystanie z wbudowanego sterownika ODP.NET zarządzanego przez Oracle dla trybu DirectQuery jest dostępne w wersji zapoznawczej. Aby uzyskać więcej informacji, zobacz poprzednie sekcje trybu DirectQuery.
• Plik ODAC.config może wymagać uprawnień administratora do edycji, a aplikacja ze Sklepu Power BI nie zezwala na modyfikowanie tego pliku.
• Zmiany wprowadzone w ODAC.config są zastępowane podczas uaktualniania i należy zapisać plik w innej lokalizacji przed uaktualnieniem.
• Aby lokalna brama danych działała prawidłowo, upewnij się, że użytkownik, w ramach którego działa usługa bramy, ma dostęp do folderu wskazanego przez TNS_ADMIN.
• Uruchom ponownie program Power BI Desktop lub lokalną usługę bramy danych po zastosowaniu zmian konfiguracji.

Ograniczenia i zagadnienia

Sesje usługi Power BI nadal mogą być aktywne w bazie danych Oracle przez około 30 minut po odświeżeniu modelu semantycznego do tej bazy danych Oracle. Dopiero po około 30 minutach te sesje staną się nieaktywne/usunięte w bazie danych Oracle. Jest to zamierzone działanie.

Rozwiązywanie problemów

Jeśli składnia nazewnictwa jest niepoprawna lub nie została prawidłowo skonfigurowana, może wystąpić dowolny z kilku błędów z bazy danych Oracle:

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

Te błędy mogą wystąpić, jeśli deskryptor połączenia bazy danych Oracle tnsnames.ora jest nieprawidłowo skonfigurowany, podana nazwa usługi sieciowej jest błędnie wpisana, albo nasłuchiwacz bazy danych Oracle nie jest uruchomiony lub jest nieosiągalny, na przykład gdy zapora blokuje nasłuchiwacz lub port bazy danych. Upewnij się, że spełniasz wymagania wstępne dotyczące minimalnej instalacji. Więcej informacji: Wymagania wstępne

Odwiedź portal Pomocy dotyczącej błędów bazy danych Oracle, aby zapoznać się z typowymi przyczynami i rozwiązaniami dla konkretnego napotkania błędu Oracle. Wprowadź swój błąd Oracle w polu wyszukiwania portalu.

W przypadku korzystania z trybu DirectQuery za pośrednictwem lokalnej bramy danych z wbudowanym sterownikiem Oracle błędy, takie jak następujące, mogą wskazywać, że nie można rozpoznać aliasu usługi TNS:

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

Jeśli wystąpią te błędy, sprawdź, czy TNS_ADMIN jest ustawione w zakresie systemowym (komputera) oraz czy konto usługi bramy danych ma dostęp do folderu, na który wskazuje, a następnie uruchom ponownie usługę lokalnej bramy danych. Aby uzyskać więcej informacji, zobacz Obsługiwane sposoby określenia TNS_ADMIN przy użyciu wbudowanego sterownika Oracle oraz przewodnik firmy Oracle Rozwiązywanie problemów z usługami Oracle Net Services.

Znane problemy z wbudowanym sterownikiem Oracle

Następujące znane problemy są specyficzne dla wbudowanego sterownika ODP.NET zarządzanego przez firmę Oracle. Kilka obejść powraca do sterownika ODP.NET niezarządzanego, wyłączając wbudowany sterownik. Aby zapoznać się z krokami wyłączenia dla każdej powierzchni — Power BI Desktop Import i DirectQuery oraz Import i DirectQuery bramy — zobacz Używanie wbudowanego sterownika Oracle.

Aliasy TNS w udziale sieciowym nie są rozpoznawane

Dotyczy lokalnej bramy danych zarówno w trybie Import, jak i DirectQuery.

Gdy pliki konfiguracji sieci Oracle (tnsnames.ora lub TNS_ADMIN katalog) są przechowywane w udziale sieciowym (ścieżka UNC), wbudowany sterownik stale nie może rozpoznać nazwy usługi sieci (alias TNS). Może zostać wyświetlony komunikat ORA-12154: TNS:could not resolve the connect identifier specified lub ORA-50201: Failed to connect to server. Ten sam alias jest rozpoznawany poprawnie za pomocą sterownika ODP.NET niezarządzanego lub gdy pliki znajdują się w ścieżce lokalnej. Wbudowany sterownik zarządzany nie niezawodnie odczytuje plików konfiguracji sieci Oracle z lokalizacji UNC.

Użyj jednego z następujących obejść:

• Skopiuj tnsnames.ora (i sqlnet.ora jeśli używasz go) do folderu na dysku lokalnym, a następnie wskaż sterownik w tym folderze. Zobacz Obsługiwane sposoby określania TNS_ADMIN za pomocą wbudowanego sterownika Oracle. W przypadku trybu DirectQuery bramy ustaw TNS_ADMIN zakres systemu (maszyny), ponieważ konto usługi bramy nie może odczytać zmiennych o zakresie użytkownika, a następnie ponownie uruchom usługę bramy.
• Upewnij się, że konto usługi z uruchomioną bramą ma dostęp do udziału sieciowego.
• Wprowadź deskryptor Easy Connect bezpośrednio na serwerze (na przykład host:port/service_name) zamiast tnsnames.ora aliasu, więc nie jest wymagany żaden plik konfiguracji sieci.
• Wyłącz wbudowany sterownik, aby wrócić do sterownika ODP.NET niezarządzanego, który może odczytywać pliki z udziału.

NLS_LANG jest ignorowany

Dotyczy Power BI Desktop, lokalnej bramy danych i połączeń usługa Power BI w chmurze zarówno w trybie Import, jak i DirectQuery.

W przypadku wbudowanego sterownika język sesji Oracle, terytorium i formaty liczb i dat są zgodne z kulturą .NET maszyny (Windows ustawienia regionalne i formatujące), a nie zmienną NLS_LANG środowiskową. Ustawienie lub zmiana NLS_LANG nie ma wpływu. W zależności od regionu maszyny to zachowanie może spowodować przeanalizowanie liczb lub dat za pomocą nieprawidłowych separatorów lub kolejności dat, zapytań w celu zwrócenia zera wierszy lub nieprawidłowych wartości lub błędów, takich jak ORA-01722, ORA-01858, ORA-01861lub ORA-01843. Na przykład raport utworzony na maszynie ustawiony na angielski (Stany Zjednoczone) może zwracać zero wierszy lub błędów na maszynie ustawionej na angielski (Wielka Brytania). Zarządzany sterownik ODP.NET pobiera ustawienia national language support (NLS) z kultury wątku .NET, a nie z NLS_LANG, w przeciwieństwie do sterownika ODP.NET niezarządzanego, który honoruje NLS_LANG.

Użyj jednego z następujących obejść:

• Dopasuj ustawienia regionalne maszyny do ustawień regionalnych, dla których zostały zaprojektowane dane i zapytania.
• Wyłącz wbudowany sterownik, aby wrócić do odp.NET niezarządzany kierowca, który honoruje NLS_LANG.

Aby zapoznać się z zachowaniem globalizacji zarządzanego sterownika, zobacz dokumentację pomocy technicznej firmy Oracle dotyczącą globalizacji .

FetchSize w rejestrze nie jest używany przez wbudowany sterownik

Dotyczy Power BI Desktop i lokalnej bramy danych dla modeli importu Oracle.

Po przełączeniu się do wbudowanego sterownika modele importu Oracle mogą być odświeżane wolniej niż w przypadku sterownika ODP.NET niezarządzanego. Wbudowany zarządzany dostawca ODP.NET nie odczytuje FetchSize właściwości z rejestru. Domyślnym ustawieniem FetchSize dla dostawców niezarządzanych i zarządzanych dla odp.NET jest 128 KB w wersji 23.26.2 i starszych, w tym dostawcy 23.6, który Power BI zawiera. Dostawca zarządzany ignoruje wszelkie FetchSize przesłonięcia skonfigurowane w rejestrze.

Wyłącz wbudowany sterownik, aby wrócić do sterownika ODP.NET niezarządzanego, który honoruje ustawienie rejestruFetchSize. W lokalnej bramie danych ustaw wartość MashupFlight_DisableOracleBundledOdacProviderV2True w konfiguracji dostawcy pakietów w ustawieniach bramy.

Uwierzytelnianie użytkownika serwera proxy Oracle nie jest obsługiwane

Dotyczy lokalnej bramy danych (wersja z czerwca 2026 r. i nowszej) dla programu Oracle Import i DirectQuery używającego konta serwera proxy Oracle.

Po uaktualnieniu do bramy z czerwca 2026 r., która jest domyślna dla wbudowanego dostawcy zarządzanego, Power BI raporty, które łączą się z bazą danych Oracle przy użyciu konta serwera proxy Oracle, kończą się niepowodzeniem zarówno w trybie Import, jak i DirectQuery. To samo źródło danych działa, gdy połączenie korzysta z konta Oracle innego niż proxy. Uwierzytelnianie serwera proxy bazy danych Oracle Database — łączenie się jako jeden użytkownik bazy danych w imieniu innego schematu (na przykład User Id=proxy_user[target_schema] formularza) — nie jest obsługiwane przez wersję 23.6 wbudowanego dostawcy odp.NET dostarczanego obecnie z Power BI.

Użyj jednego z następujących obejść:

• Jeśli to możliwe, użyj konta Oracle innego niż proxy.
• W przypadku opcji Importuj wyłącz wbudowany sterownik importu w bramie, ustawiając MashupFlight_DisableOracleBundledOdacProviderV2Truewartość , więc brama wraca do sterownika ODP.NET niezarządzanego, który obsługuje konta serwera proxy.
• W przypadku trybu DirectQuery ustawienie Importuj nie ma zastosowania. Skontaktuj się z pomoc techniczna firmy Microsoft, aby wyłączyć wbudowany sterownik dla ścieżki DirectQuery bramy. Ta konfiguracja nie jest obecnie samoobsługowa.

Nie można zaktualizować poświadczeń połączenia z chmurą osobistą Oracle

Dotyczy usługa Power BI w przypadku połączeń z chmurą osobistą Oracle.

Na stronie Zarządzanie połączeniami i bramami w usługa Power BI aktualizowanie poświadczeń osobistego połączenia w chmurze Oracle nie działa. Zamiast tego zaktualizuj poświadczenia w okienku ustawień modelu semantycznego:

1. Otwórz okienko ustawień modelu semantycznego i przejdź do pozycji Brama i połączenia w chmurze.
2. Ustaw źródło danych tak, aby używało osobistego połączenia w chmurze.
3. W obszarze Poświadczenia źródła danych zmodyfikuj poświadczenia źródła danych.

Jeśli program Power BI Desktop został pobrany ze Sklepu Microsoft, być może nie możesz nawiązać połączenia z bazami danych Oracle z powodu problemu ze sterownikiem Oracle. Jeśli wystąpi ten problem, zwracany komunikat o błędzie to: Odwołanie do obiektu nie jest ustawione. Aby rozwiązać ten problem, pobierz program Power BI Desktop z Centrum pobierania zamiast ze Sklepu Microsoft.

Jeśli w usłudze Power BI pojawi się komunikat o błędzie Odwołanie do obiektu nie zostało ustawione podczas nawiązywania połączenia z bazą danych Oracle przy użyciu lokalnej bramy danych, postępuj zgodnie z instrukcjami w temacie Zarządzanie źródłem danych — Oracle.

Jeśli używasz serwera raportów usługi Power BI, zapoznaj się ze wskazówkami w artykule Typ połączenia Oracle .

Treści powiązane

Optymalizowanie dodatku Power Query podczas rozszerzania kolumn tabeli