PostgreSQL

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	Baza danych (nazwa użytkownika/hasło) Konto Microsoft (Microsoft Entra ID)
Dokumentacja referencyjna funkcji	PostgreSQL.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

Program Power BI Desktop od grudnia 2019 r. uwzględnia dostawcę Npgsql dla konektora PostgreSQL, eliminując konieczność dodatkowej instalacji. Począwszy od wersji z października 2024 r., obejmuje ona program Npgsql w wersji 4.0.17. Oddzielna instalacja usługi Npgsql GAC zastąpi tę domyślną wersję.

Łącznik PostgreSQL jest obsługiwany dla połączeń w chmurze oraz poprzez bramę danych sieci wirtualnej (VNet) lub lokalną bramę danych. Od wersji z czerwca 2025 r. lokalna brama danych obejmuje dostawcę npgsql, więc nie jest wymagana dodatkowa instalacja. Oddzielna instalacja usługi Npgsql GAC zastąpi tę domyślną wersję.

W przypadku wersji programu Power BI Desktop wydanych przed grudniem 2019 r. i lokalnej bramy danych wydanej przed czerwcem 2025 r. należy zainstalować dostawcę npgsql na komputerze lokalnym, aby użyć łącznika PostgreSQL. Aby zainstalować dostawcę Npgsql, przejdź na stronę wersji 4.0.17, pobierz i uruchom plik .msi. Architektura dostawcy (32-bitowa lub 64-bitowa) musi być zgodna z architekturą produktu, w którym zamierzasz używać łącznika. Podczas instalacji upewnij się, że wybrano opcję instalacji Npgsql GAC, aby zestaw Npgsql został dodany do Twojego komputera. Program Npgsql 4.1 i nowsze nie są obsługiwane z powodu niezgodności wersji platformy .NET.

Obsługiwane możliwości

• Importowanie
• DirectQuery (modele semantyczne Power BI)
• Opcje zaawansowane
  • Czas oczekiwania polecenia w minutach
  • Natywna instrukcja SQL
  • Kolumny relacji
  • Nawigowanie przy użyciu pełnej hierarchii

Nawiązywanie połączenia z bazą danych PostgreSQL z poziomu programu Power Query Desktop

Po zainstalowaniu zgodnego dostawcy npgsql można nawiązać połączenie z bazą danych PostgreSQL. Aby nawiązać połączenie, wykonaj następujące czynności:

1. Wybierz opcję bazy danych PostgreSQL w wyborze łącznika. Aby uzyskać więcej informacji, przejdź do Gdzie uzyskać dane.

2. W wyświetlonym oknie dialogowym bazy danych PostgreSQL podaj nazwę serwera i bazy danych.

   

3. Wybierz tryb łączności danych Import lub DirectQuery .

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

   • 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. Jeśli połączenie nie jest zaszyfrowane, zostanie wyświetlony następujący komunikat.

   

   Wybierz przycisk OK , aby nawiązać połączenie z bazą danych przy użyciu nieszyfrowanego połączenia. Jeśli wymagane jest zaszyfrowane połączenie, należy skonfigurować serwer PostgreSQL w celu uwzględnienia połączeń SSL (przejdź do dokumentacji bazy danych PostgreSQL , aby uzyskać wskazówki). Po zakończeniu może być wymagane zainstalowanie certyfikatu SSL serwera PostgreSQL w zaufanych głównych urzędach certyfikacji.

6. W nawigatorze wybierz żądane informacje o bazie danych, a następnie wybierz pozycję Załaduj , aby załadować dane lub Przekształć dane , aby kontynuować przekształcanie danych w edytorze Power Query.

   

Nawiązywanie połączenia z bazą danych PostgreSQL z poziomu usługi Power Query Online

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

1. Wybierz opcję bazy danych PostgreSQL w wyborze łącznika. Aby uzyskać więcej informacji, przejdź do Gdzie uzyskać dane.

2. W wyświetlonym oknie dialogowym bazy danych PostgreSQL podaj nazwę serwera i bazy danych.

   

3. Wybierz nazwę lokalnej bramy danych, której chcesz użyć.

4. Wybierz rodzaj uwierzytelniania podstawowego i wprowadź poświadczenia bazy danych PostgreSQL w polach Nazwa użytkownika i Hasło .

5. Jeśli Twoje połączenie nie jest zaszyfrowane, odznacz Użyj zaszyfrowanego połączenia.

6. Wybierz przycisk Dalej , aby nawiązać połączenie z bazą danych.

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

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

Power Query Desktop zapewnia zbiór zaawansowanych opcji, które możesz dodać do zapytania w razie potrzeby.

Poniższa tabela zawiera wszystkie opcje zaawansowane, które możesz ustawić w Power Query Desktop.

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ć kolejną wartość w minutach, aby połączenie było otwarte dłużej. 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 zostanie 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, aby nawiązać połączenie z bazą danych PostgreSQL.

Składanie zapytań natywnych

Składanie zapytań natywnych jest domyślnie włączone. Operacje, które mogą być grupowane, są stosowane na bazie zapytania natywnego zgodnie z normalną logiką importu lub Zapytania Bezpośredniego. Składanie zapytań natywnych nie ma zastosowania w przypadku parametrów opcjonalnych znajdujących się w elemecie Value.NativeQuery.

W rzadkich przypadkach, gdy składanie nie działa z włączonym natywnym składaniem zapytań, można je wyłączyć. Aby wyłączyć składanie zapytań natywnych, w edytorze zaawansowanym ustaw flagę EnableFolding na false dla Value.NativeQuery.

Przykład: Value.NativeQuery(target as any, query, null, [EnableFolding=false])

Rozwiązywanie problemów

Zapytanie natywne może zgłosić następujący błąd:

We cannot fold on top of this native query. Please modify the native query or remove the 'EnableFolding' option.

Podstawowym krokiem rozwiązywania problemów jest sprawdzenie, czy zapytanie w Value.NativeQuery zgłasza ten sam błąd z klauzulą limit 1 wokół zapytania.

select * from (query) _ limit 1