Udostępnij za pośrednictwem

Oracle Database

  • Artykuł

Podsumowanie

Element opis
Stan 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 (desktop/online)
Baza danych (pulpit)
Podstawowa (online)
Konto Microsoft (pulpit)
Dokumentacja referencyjna funkcji Oracle.Database

Uwaga

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

Przed nawiązaniem połączenia z bazą danych Oracle przy użyciu dodatku Power Query należy zainstalować klienta Oracle dla narzędzi firmy Microsoft (OCMT).

Aby nawiązać połączenie z bazą danych Oracle przy użyciu lokalnej bramy danych, na komputerze z uruchomioną bramą musi być zainstalowany 64-bitowy protokół OCMT. Aby uzyskać więcej informacji, zobacz Zarządzanie źródłem danych — Oracle.

Obsługiwane możliwości

  • Importuj
  • Tryb DirectQuery (modele semantyczne usługi Power BI)
  • Opcje zaawansowane
    • Limit czasu polecenia w minutach
    • SQL statement
    • Dołącz kolumny relacji
    • Nawiguj, używając pełnej hierarchii

Pobieranie i instalowanie klienta Oracle Dla narzędzi firmy Microsoft

Program Oracle Client for Microsoft Tools instaluje i konfiguruje Dostawca danych Oracle dla platformy .NET (ODP.NET), aby obsługiwać 32-bitowe i 64-bitowe połączenia narzędzi firmy Microsoft z lokalnymi i w chmurze bazami danych Oracle, w tym autonomiczną bazą danych Oracle (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ługa 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-bitowego programu Power BI Desktop i usługa Power BI użyj 64-bitowego OCMT. W przypadku 32-bitowego programu Power BI Desktop użyj 32-bitowego OCMT.

Nawet jeśli masz już klienta Oracle Lub ODP.NET zainstalowanego na kliencie usługi Power BI, zdecydowanie zaleca się użycie instalatora OCMT w celu prawidłowego wykonania wszystkich kroków konfiguracji, które usługa Power BI wymaga współpracy z bazą danych Oracle.

Połączenie do lokalnej bazy danych Oracle z programu Power Query Desktop

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

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

  2. Określ alias usługi sieci Oracle/alias TNS lub parametry połączenia Połączenie Easy Połączenie (Plus), aby nawiązać połączenie z serwerem. Najprostszym Połączenie jest ustawienie wartości Serwera na nazwę hosta serwera bazy danych Oracle/serviceName, gdzie ServiceName jest globalną nazwą bazy danych. Poniższy zrzut ekranu używa nazwy usługi sieci.

    Wprowadź połączenie bazy danych Oracle.

  3. Jeśli łączysz się z programu Power BI Desktop, wybierz tryb łączności danych Import lub DirectQuery . W pozostałych krokach tego przykładu jest używany tryb łączności danych importu. Aby dowiedzieć się więcej na temat trybu DirectQuery, przejdź do tematu 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 Uwierzytelnianie za pomocą źródła danych.

    Wprowadź poświadczenia bazy danych Oracle.

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

Połączenie do lokalnej bazy 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 wyświetlonym oknie dialogowym Bazy danych Oracle określ alias usługi Oracle net/TNS Easy Połączenie Plus parametry połączenia lub połącz deskryptor, aby nawiązać połączenie z serwerem.

    Wprowadź połączenie online bazy danych Oracle.

  4. Podaj nazwę Połączenie ion, taką jak "testoracleserver".

  5. Wybierz nazwę lokalnej bramy danych.

    Uwaga

    Musisz wybrać lokalną bramę danych dla tego łącznika, niezależnie od tego, czy baza danych Oracle znajduje się w sieci lokalnej, czy w witrynie internetowej.

  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ź poświadczenia.

  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.

Połączenie do autonomicznej bazy danych Oracle

Uwaga

Obecnie możesz nawiązać połączenie z autonomiczną bazą danych Oracle z programu Excel, programu Power BI Desktop, usługa 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 używają niezarządzanych ODP.NET do nawiązywania połączenia. Inne narzędzia firmy Microsoft, w tym narzędzia SQL Server Data Tools, usługi SQL Server Integration Services i usługi SQL Server Reporting Services, używają zarządzanych ODP.NET do łączenia się z autonomiczną bazą danych Oracle przy użyciu w dużej mierze podobnych procedur.

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

Pobieranie poświadczeń 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ę DB Połączenie ion.

    POŁĄCZENIE DB.

  2. Na stronie Baza danych Połączenie ion wybierz pozycję Pobierz portfel.

    Pobierz portfel.

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

    Hasło portfela.

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 katalogu plików konfiguracji Oracle. W tym przykładzie poświadczenia są wyodrębniane do folderu c:\data\portfel\wallet_contosomart.

    Obraz z plikami portfeli rozpakowany w folderze portfel.

    Uwaga

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

  3. Otwórz plik sqlnet.ora w edytorze, na przykład Notatnik.

  4. W obszarze WALLET_LOCATION zmień ścieżkę do folderu portfela w obszarze Opcja 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 usługi ADB są różne.

Obraz z trzema przykładowymi nazwami TNS, contosomart_high, contosomart_low i contosomart_medium.

Połączenie programie Power BI Desktop do bazy danych Oracle ADB

  1. Otwórz Power BI Desktop.

  2. Wybierz pozycję Pobieranie danych.

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

  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.

    Obraz przedstawiający okno dialogowe Bazy danych Oracle z contosomart_high jako wybraną nazwą serwera i trybem importu.

  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łączenie.

    Obraz przedstawiający okno dialogowe poświadczeń z wybraną pozycją Baza danych oraz wprowadzoną domyślną nazwą użytkownika bazy danych i hasłem.

    Uwaga

    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.

Obraz z otwartym nawigatorem i wyświetloną bazą danych contosomart_high ze wszystkimi jej

Możesz również napotkać jeden z kilku błędów, ponieważ konfiguracja nie została 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.

Obraz nawigatora z nazwą bazy danych u góry, ale pojawia się błąd 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.

Konfigurowanie bramy

  1. Instalowanie i konfigurowanie lokalnej bramy danych.

  2. W usługa Power BI wybierz ikonę koła zębatego w prawym górnym rogu, a następnie wybierz pozycję Zarządzaj bramami.

    Obraz przedstawiający otwartą usługa Power BI wybraną ikonę koła zębatego oraz menu Zarządzanie bramami z podkreśloną pozycją Zarządzaj bramami.

  3. W obszarze Dodawanie źródła danych wybierz pozycję Dodaj źródła danych, aby użyć bramy.

    Obraz przedstawiający okno Dodawanie źródła danych w usługa Power BI z pozycją Dodaj źródło danych w celu użycia bramy z podkreślonej bramy.

  4. W polu Nazwa źródła danych wprowadź nazwę, której chcesz użyć jako ustawienia źródła danych.

  5. W polu Typ źródła danych wybierz pozycję Oracle.

  6. W polu Serwer wprowadź nazwę usługi net serwera Oracle Autonomous Database, z którymi chcesz nawiązać połączenie.

  7. W obszarze Metoda uwierzytelniania wybierz pozycję Podstawowa.

  8. Wprowadź nazwę użytkownika i hasło dla autonomicznej bazy danych Oracle. W tym przykładzie jest używana domyślna nazwa użytkownika administratora bazy danych (ADMIN) i hasło.

  9. Wybierz Dodaj.

    Obraz przedstawiający okno Ustawienia źródła danych z wypełnionymi wszystkimi ustawieniami źródła danych.

Jeśli wszystko zostało zainstalowane i skonfigurowane poprawnie, zostanie wyświetlony komunikat o powodzeniu Połączenie ion. Teraz możesz nawiązać połączenie z autonomiczną bazą danych Oracle, wykonując te same kroki opisane w Połączenie z lokalną bazą danych Oracle z usługi Power Query Online.

Połączenie 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
Limit czasu 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 zachować dłuższe otwieranie połączenia. Ta opcja jest dostępna tylko w programie Power Query Desktop.
SQL statement 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.
Nawiguj, używając 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.

Znane problemy i ograniczenia

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. Wynika to z ustawienia fabrycznego.

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: nie można rozpoznać określonego identyfikatora połączenia.
  • ORA-12514: TNS: odbiornik nie zna obecnie usługi żądanej w deskryptorze połączenia.
  • ORA-12541: TNS: brak odbiornika.
  • ORA-12170: TNS: wystąpił limit czasu połączenia.
  • ORA-12504: TNS: odbiornik nie otrzymał SERVICE_NAME w 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 net jest błędnie wpisać lub odbiornik bazy danych Oracle nie jest uruchomiony lub nieosiągalny, na przykład zapora blokująca odbiornik 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ź błąd Oracle na pasku wyszukiwania portalu.

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, wykonaj następujące czynności:

  • Pobierz program Power BI Desktop z Centrum pobierania zamiast ze Sklepu Microsoft.

Jeśli odwołanie do obiektu nie ustawiono komunikatu o błędzie w usłudze Power BI 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 Serwer raportów usługi Power BI, zapoznaj się ze wskazówkami w artykule Oracle Połączenie ion Type (Typ Połączenie Oracle).

Następne kroki

Optymalizowanie dodatku Power Query podczas rozwijania kolumn tabeli