Teilen über

PostgreSQL

  • Artikel

Zusammenfassung

Element Beschreibung
Releasestatus Allgemeine Verfügbarkeit
Produkte Excel
Power BI (Semantikmodelle)
Power BI (Dataflows)
Fabric (Dataflow Gen2)
Power Apps (Dataflows)
Dynamics 365 Customer Insights
Analyse-Dienste
Unterstützte Authentifizierungstypen Datenbank (Benutzername/Kennwort)
Referenzdokumentation zur Funktion PostgreSQL.Database

Anmerkung

Einige Funktionen sind möglicherweise in einem Produkt vorhanden, aber nicht in anderen, abhängig von Bereitstellungszeitplänen und hostspezifischen Funktionen.

Voraussetzungen

Seit Dezember 2019 wird Power BI Desktop mit NpgSQL ausgeliefert, und es ist keine zusätzliche Installation erforderlich. Ab der Version vom Oktober 2024 ist NpgSQL 4.0.17 die enthaltene Version. Die GAC-Installation überschreibt die mit Power BI Desktop bereitgestellte Standardversion. Die Aktualisierung wird sowohl über die Cloud im Power BI-Dienst als auch vor Ort über das On-Premise-Datagateway unterstützt. Um Daten aus dem Power BI-Dienst ohne ein lokales Datengateway zu aktualisieren, muss PostgreSQL so gehostet werden, dass eine direkte Verbindung von den Power BI-Diensten in Azure möglich ist. Dies wird nativ für PostgreSQL unterstützt, die in Microsoft Azure gehostet wird. Wenden Sie sich für andere Hostingumgebungen an Ihren Hostinganbieter, um Ihre PostgreSQL für den direkten Zugriff über das Internet zu konfigurieren. Wenn PostgreSQL so konfiguriert ist, dass nicht direkt über das Internet zugegriffen werden kann (empfohlen für Sicherheit), müssen Sie ein lokales Datengateway für Aktualisierungen verwenden. Im Power BI-Dienst wird NpgSQL 4.0.17 verwendet. Bei der lokalen Aktualisierung wird dagegen die lokale Installation von NpgSQL genutzt, sofern diese verfügbar ist, und andernfalls NpgSQL 4.0.17.

Für power BI Desktop-Versionen, die vor Dezember 2019 veröffentlicht wurden, müssen Sie den NpgSQL-Anbieter auf Ihrem lokalen Computer installieren. Um den NpgSQL-Anbieter zu installieren, wechseln Sie zur Seite mit den Releases, suchen Sie nach der aktuellen Version v4.0.x, laden Sie die MSI-Datei herunter, und führen Sie sie aus. Die Anbieterarchitektur (32-Bit oder 64-Bit) muss mit der Architektur des Produkts übereinstimmen, in dem Sie den Connector verwenden möchten. Stellen Sie bei der Installation sicher, dass Sie die NpgSQL GAC-Installation auswählen, um sicherzustellen, dass NpgSQL selbst zu Ihrem Computer hinzugefügt wird.

Wir empfehlen NpgSQL 4.0.17. NpgSQL 4.1 und up funktionieren aufgrund von .NET-Versionsinkompatibilitäten nicht.

Npgsql-Installationsprogramm mit Auswahl der GAC-Installation

Für Power Apps müssen Sie den NpgSQL-Anbieter auf Ihrem lokalen Computer installieren. Um den NpgSQL-Anbieter zu installieren, wechseln Sie zur -Release-Seite, und laden Sie die entsprechende Version herunter. Laden Sie das Installationsprogramm (Datei „NpgSQL-[Versionsnummer].msi“) herunter, und führen Sie es aus. Stellen Sie sicher, dass Sie die NpgSQL GAC-Installation auswählen und den Computer nach Abschluss neu starten, damit diese Installation wirksam wird.

Unterstützte Funktionen

  • Importieren
  • DirectQuery (Power BI-Semantikmodelle)
  • Erweiterte Optionen
    • Befehlstimeout in Minuten
    • Native SQL-Anweisung
    • Beziehungsspalten
    • Navigieren mithilfe der vollständigen Hierarchie

Herstellen einer Verbindung mit einer PostgreSQL-Datenbank über Power Query Desktop

Sobald der entsprechende Npgsql-Anbieter installiert ist, können Sie eine Verbindung mit einer PostgreSQL-Datenbank herstellen. Führen Sie die folgenden Schritte aus, um die Verbindung herzustellen:

  1. Wählen Sie in der Connectorauswahl die Option PostgreSQL-Datenbank aus.

  2. Geben Sie im angezeigten Dialogfeld PostgreSQL-Datenbank den Namen des Servers und der Datenbank an.

    PostgreSQL-Verbindungs-Generator in Power BI.

  3. Wählen Sie den Datenkonnektivitätsmodus Importieren oder DirectQuery aus.

  4. Wenn Sie zum ersten Mal eine Verbindung mit dieser Datenbank herstellen, geben Sie Ihre PostgreSQL-Anmeldeinformationen in die Felder Benutzername und Kennwort des Authentifizierungstyps Datenbank ein. Wählen Sie die Ebene aus, auf die die Authentifizierungseinstellungen angewendet werden sollen. Wählen Sie dann Verbinden aus.

    Geben Sie Ihren PostgreSQL-Benutzernamen und Ihr Kennwort ein.

    Weitere Informationen zur Verwendung von Authentifizierungsmethoden finden Sie unter Authentifizierung mit einer Datenquelle.

    Anmerkung

    Wenn die Verbindung nicht verschlüsselt ist, werden Sie mit der folgenden Meldung aufgefordert.

    Unterstützung für die Azure SQL-Datenbankverschlüsselung.

    Wählen Sie OK aus, um mithilfe einer unverschlüsselten Verbindung eine Verbindung mit der Datenbank herzustellen, oder folgen Sie den Anweisungen in Aktivieren von verschlüsselten Verbindungen mit dem Datenbankmodul, um verschlüsselte Verbindungen mit der PostgreSQL-Datenbank einzurichten.

  5. Wählen Sie im Navigator die gewünschten Datenbankinformationen aus. Wählen Sie anschließend Laden aus, um die Daten zu laden, oder Daten transformieren, um die Daten im Power Query-Editor weiter zu transformieren.

    Power Query Desktop-Navigator mit den Mitarbeiterdaten (HumanResources.Employee) in der PostgreSQL-Datenbank

Herstellen einer Verbindung mit einer PostgreSQL-Datenbank über Power Query Online

Führen Sie die folgenden Schritte aus, um die Verbindung herzustellen:

  1. Wählen Sie in der Connectorauswahl die Option PostgreSQL-Datenbank aus.

  2. Im angezeigten Dialogfeld der PostgreSQL-Datenbank geben Sie den Namen des Servers und der Datenbank an.

    PostgreSQL-Verbindungs-Generator in Power Query Online.

  3. Wählen Sie den Namen des lokalen Datengateways aus, das Sie verwenden möchten.

  4. Wählen Sie die Standardauthentifizierungsart aus, und geben Sie Ihre PostgreSQL-Anmeldeinformationen in die Felder Benutzername und Kennwort ein.

  5. Wenn Ihre Verbindung nicht verschlüsselt ist, deaktivieren Sie Verschlüsselte Verbindung verwenden.

  6. Wählen Sie Weiter aus, um eine Verbindung mit der Datenbank herzustellen.

  7. Wählen Sie im Navigator die benötigten Daten und dann Daten transformieren aus, um die Daten im Power Query-Editor zu transformieren.

Herstellen einer Verbindung mit erweiterten Optionen

Power Query Desktop bietet bei Bedarf eine Reihe erweiterter Optionen, die Sie Ihrer Abfrage hinzufügen können.

Erweiterte Optionen im Dialogfeld für die PostgreSQL-Verbindung

In der folgenden Tabelle sind alle erweiterten Optionen aufgeführt, die Sie in Power Query Desktop festlegen können.

Erweiterte Option Beschreibung
Befehlstimeout in Minuten Wenn Ihre Verbindung länger als 10 Minuten dauert (Standard-Timeout), können Sie einen anderen Wert in Minuten eingeben, um die Verbindung länger offen zu halten. Diese Option ist nur in Power Query Desktop verfügbar.
SQL-Anweisung Informationen hierzu finden Sie unter Importieren von Daten aus einer Datenbank mit nativer Datenbankabfrage.
Beziehungsspalten einbeziehen Wenn diese Option aktiviert ist, werden Spalten einbezogen, die möglicherweise Beziehungen zu anderen Tabellen aufweisen. Wenn dieses Feld deaktiviert ist, werden diese Spalten nicht angezeigt.
Navigieren mithilfe der vollständigen Hierarchie Wenn diese Option aktiviert ist, zeigt der Navigator die vollständige Hierarchie von Tabellen in der Datenbank an, mit der Sie eine Verbindung herstellen. Wenn sie deaktiviert ist, werden im Navigator nur die Tabellen angezeigt, deren Spalten und Zeilen Daten enthalten.

Nachdem Sie die erforderlichen erweiterten Optionen ausgewählt haben, wählen Sie OK in Power Query Desktop aus, um eine Verbindung mit Ihrer PostgreSQL-Datenbank herzustellen.

Natives Query Folding

Natives Query Folding ist standardmäßig aktiviert. Vorgänge, die die Faltung unterstützen, werden gemäß der normalen Import- oder Direct Query-Logik zusätzlich zur nativen Abfrage angewendet. Natives Query Folding ist nicht anwendbar, wenn optionale Parameter in Value.NativeQuery() vorhanden sind.

In dem seltenen Fall, dass die Faltung nicht funktioniert, wenn natives Query Folding aktiviert ist, können Sie es deaktivieren. Um natives Query Folding zu deaktivieren, legen Sie im erweiterten Editor das EnableFolding-Flag für Value.NativeQuery() auf false fest.

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

Fehlerbehebung

Die native Abfrage kann den folgenden Fehler auslösen:

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

Ein einfacher Schritt zur Problembehandlung besteht darin, zu überprüfen, ob die Abfrage in Value.NativeQuery() mit einer limit 1-Klausel denselben Fehler auslöst:

select * from (query) _ limit 1