Freigeben über

Entwickeln eines Konnektors mit dem Power Query SDK

  • Artikel

Das Power Query SDK ist eine Reihe von Tools, mit denen Sie Power Query-Connectors erstellen können. Diese Connectors werden häufig als benutzerdefinierte Connectors oder Power Query-Erweiterungen bezeichnet.

Mit benutzerdefinierten Connectors können Sie neue Datenquellen erstellen oder eine vorhandene Quelle anpassen und erweitern. Gängige Anwendungsfälle:

  • Erstellen einer für Geschäftsanalysten geeigneten Ansicht für eine REST-API.
  • Bereitstellung von Branding für eine Quelle, die Power Query mit einem vorhandenen Konnektor (z. B. einem OData-Dienst oder ODBC-Treiber) unterstützt.
  • Implementierung des OAuth v2-Authentifizierungsflusses für ein SaaS-Angebot.
  • Offenlegung einer eingeschränkten oder gefilterten Ansicht Ihrer Datenquelle zur Verbesserung der Benutzerfreundlichkeit.
  • Aktivieren von DirectQuery für eine Datenquelle mithilfe eines ODBC-Treibers.

Installieren des Power Query SDK

Installieren Sie das Visual Studio Code Power Query SDK aus dem Visual Studio Code-Bereich des Visual Studio Marketplace. Klicken Sie auf Installieren, um SDK zu installieren.

Prozess der Entwicklung des Connectors

Die folgenden Abschnitte geben Ihnen einen Überblick über die gängigsten Verfahren zur Erstellung eines Power Query Connectors mithilfe des SDK.

Erstellung einer neuen Erweiterung

Beim Erstellen eines neuen Arbeitsbereichs (Visual Studio Code Power Query SDK) beginnen Sie mit den folgenden Core-Dateien:

  • Connector Definitionsdatei (<connectorName>.pq)
  • Eine Abfragedatei (<connectorName>.query.pq)
  • Eine String-Ressourcen-Datei (resources.resx)
  • PNG-Dateien in verschiedenen Größen zum Erstellen von Symbolen

Ihre Connector-Definitionsdatei beginnt mit einer leeren Datenquellenbeschreibung. Mehr über eine Datenquelle im Zusammenhang mit dem Power Query SDK erfahren Sie in dem Artikel über Handhabung des Datenzugriffs.

Testen

Das Power Query SDK bietet grundlegende Funktionen zur Ausführung von Abfragen, mit denen Sie Ihre Erweiterung testen können, ohne zu einer anderen Clientanwendung wechseln zu müssen. Weiter testen können Sie Ihren Connector in einer Anwendung wie:

Testdatei abfragen

Zusätzlich zur Erweiterungsdatei können Data Connector Projekte eine Abfragedatei (name.query.pq) enthalten. Diese Datei kann verwendet werden, um Testabfragen in Visual Studio Code auszuführen. Die Abfrageauswertung wird automatisch Ihren Erweiterungscode einbeziehen, ohne dass Sie Ihre.pqx-Datei registrieren müssen, so dass Sie alle gemeinsam genutzten Funktionen in Ihrem Erweiterungscode aufrufen oder testen können.

Die Abfragedatei kann einen einzelnen Ausdruck (z. B. HelloWorld.Contents()), einen let Ausdruck (wie ihn Power Query erzeugen würde) oder ein Abschnittsdokument enthalten.

Erstellen und Bereitstellen

Wenn Sie Ihr Projekt erstellen, erhalten Sie Ihre .mez-Datei oder Erweiterungsdatei. Power Query-Erweiterungen werden in einer ZIP-Datei gebündelt und erhalten die Dateierweiterung .mez.

Erweiterungen werden in einem M-Abschnitt-Dokument definiert. Ein Abschnittsdokument hat ein etwas anderes Format als das/die in Power Query generierte(n) Abfragedokument(e). Code, den Sie aus Power Query importieren, muss in der Regel geändert werden, damit er in ein Abschnittsdokument passt, aber die Änderungen sind gering. Zu den Unterschieden zwischen den Abschnittsdokumenten, die Sie kennen sollten, gehören:

  • Sie beginnen mit einer Abschnittserklärung (zum Beispiel section HelloWorld;).
  • Jeder Ausdruck endet mit einem Semikolon (zum Beispiel a = 1; oder b = let c = 1 + 2 in c;).
  • Alle Funktionen und Variablen sind lokal für das Abschnittsdokument, es sei denn, sie sind als gemeinsam genutzt gekennzeichnet. Gemeinsam genutzte Funktionen werden für andere Abfragen/Funktionen sichtbar und können als Exporte für Ihre Erweiterung betrachtet werden (d. h. sie werden von Power Query aus aufrufbar).

Weitere Informationen zu den Dokumenten der Sektion M finden Sie in der M-Language-Spezifikation.

Verteilung von Power Query-Connectors

Es gibt zwei Pfade, in denen Sie Ihren Connector verteilen können:

  • Selbstverteilung
  • Zertifizierung von Konnektoren

Selbstverteilung

Ein Self-Service-Mechanismus, mit dem Sie benutzerdefinierte Power Query-Connectors in entsprechenden Produktumgebungen anwenden können

Wenn Ihr Connector erstellt ist, können Sie diese Datei nach Wunsch an Ihre Benutzer senden, die den Connector dann in entsprechenden Produktumgebungen wie Microsoft Power BI verwenden können.

Microsoft Power BI

Sie können Ihren eigenen benutzerdefinierten Connector in Microsoft Power BI Desktop und im Microsoft Power BI-Dienst für semantische Modelle zur Aktualisierung und Konnektivität in der Cloud einsetzen.

Power Query-Connectors können in drei Umgebungen geladen werden:

  • Lokales Datengateway: Ihr Connector kann über das Gateway zur Verwendung in den Microsoft Fabric- und Microsoft Power BI-Diensten geladen werden
  • Power Query Online: in Umgebungen wie Power BI Datamarts, Fabric Dataflow Gen2 und vielen anderen
  • Power Query Desktop: in Umgebungen wie Power BI Desktop.

Weitere Informationen zur Verwendung Ihres benutzerdefinierten Connectors für die Selbstverteilung finden Sie in den folgenden Artikeln:

Zertifizierung von Konnektoren

Das Zertifizierungsprogramm für den Data Factory-Connector ermöglicht Ihnen das Übermitteln Ihres Connectors an Microsoft zur Zertifizierung, wobei Microsoft die Veröffentlichung und Verteilung Ihres Connectors in Microsoft Fabric und Microsoft Power BI für entsprechende Produkte und Umgebungen übernimmt:

  • Power Query Desktop: Microsoft Power BI Desktop.
  • Power Query Online: Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1 und andere
  • Lokales Datengateway: Für Microsoft Fabric und Microsoft Power BI unter Verwendung eines Gateways für die authentifizierte Aktualisierung oder Konnektivität.

Erfahren Sie mehr über das Zertifizierungsprogramm für den Data Factory-Connector.