Power Query Connector-Zertifizierung

Artikel
01/18/2024

Hinweis

In diesem Artikel werden die Anforderungen und der Prozess zum Einreichen eines benutzerdefinierten Power Query-Connectors zur Zertifizierung beschrieben. Lesen Sie den gesamten Artikel sorgfältig durch, bevor Sie mit dem Zertifizierungsprozess beginnen.

Einführung

Mit dem Power Query SDK können alle Benutzer einen benutzerdefinierten Power Query-Connector erstellen, um eine Verbindung mit einer Datenquelle aus Power Query herzustellen. Derzeit werden benutzerdefinierte Connectors nur in semantischen Modellen von Power BI (Power BI Desktop und Power BI-Dienst) unterstützt und erfordern die Verwendung eines lokalen Datengateways zur Aktualisierung über den Power BI-Dienst. Benutzerdefinierte Connectors müssen vom Entwickler einzeln verteilt werden.

Datenquellenbesitzer, die einen benutzerdefinierten Connector für ihre Datenquelle entwickeln, möchten möglicherweise ihren benutzerdefinierten Connector breiter an Power Query-Benutzer verteilen. Sobald ein benutzerdefinierter Connector erstellt, verwendet und von Endbenutzern validiert wurde, kann der Besitzer der Datenquelle ihn zur Microsoft-Zertifizierung einreichen.

Durch das Zertifizieren eines benutzerdefinierten Power Query-Connectors wird der Connector in semantischen Modellen von Power BI (Power BI Desktop und Power BI-Dienst), Power BI-Dataflows und Power BI-Datamarts öffentlich zur Verfügung gestellt. Zertifizierte Connectors werden in PowerBI.com und allen Versionen von Power BI Premium unterstützt.

Zertifizierte Connectors werden:

vom Partnerentwickler verwaltet.
vom Partnerentwickler unterstützt.
von Microsoft zertifiziert.
von Microsoft verteilt.

Wir arbeiten mit Partnern zusammen, um sicherzustellen, dass sie Unterstützung bei der Wartung erhalten. Kundenprobleme mit dem Connector selbst werden jedoch an den Partnerentwickler weitergeleitet.

Unterschiede zwischen einem zertifizierten Connector und einem benutzerdefinierten Connector

Zertifizierte Connectors werden in Power BI Desktop gebündelt und in Power BI-Dienst, Power BI-Dataflows und Power BI-Datamarts bereitgestellt. Benutzerdefinierte Connectors werden nur in semantischen Modellen von Power BI unterstützt und müssen in Power BI Desktop geladen werden, wie unter Ihre Erweiterung in Power BI Desktop laden beschrieben. Sowohl zertifizierte als auch benutzerdefinierte Connectors können über Power BI Desktop oder den Power BI-Dienst über ein lokales Datengateway aktualisiert werden, indem sie eine TestConnection implementieren. Das lokale Datengateway ist für benutzerdefinierte Connectors erforderlich.

Zertifizierte Connectors in Power BI Desktop mit einer TestConnection Implementierung unterstützen auch die End-to-End-Aktualisierung über die Cloud (Power BI-Dienst), ohne dass ein lokales Datengateway erforderlich ist. Die Power BI-Dienstumgebung hostet im Wesentlichen ein „Cloudgateway“, das dem lokalen Gateway ähnelt. Nach der Zertifizierung stellen wir Ihren Connector in dieser Umgebung bereit, damit er für alle Power BI-Kunden verfügbar ist.

Sowohl benutzerdefinierte als auch zertifizierte Connectors mit zusätzlichen Komponenten (z. B. ODBC-Treiber) benötigen die zusätzliche Komponente, die auf dem Endbenutzercomputer installiert werden muss und das lokale Datengateway erfordert, es sei denn, die zusätzliche Komponente wird in der Power BI-Cloud bereitgestellt. Derzeit zertifizieren und stellen wir keine neuen zusätzlichen Komponenten für die Power BI-Cloud bereit, sodass die Zertifizierung von Connectors mit einer Abhängigkeit von einer zusätzlichen Komponente nicht dazu führt, dass die Anforderung eines lokalen Datengateways entfällt.

Verteilung benutzerdefinierter Connectors

Benutzerdefinierte Connectors können und sollten vor der Zertifizierung an Endbenutzer verteilt werden.

Da M eine vielseitige Sprache ist, die, wie bei der Durchführung der Authentifizierung beobachtet werden kann, die Fähigkeit hat, mit gespeicherten Anmeldeinformationen zu interagieren, müssen wir Benutzern eine Möglichkeit geben, nur die Ausführung vertrauenswürdiger Connectors zuzulassen.

Aus der Sicht eines Entwicklers müssen Entwickler ihren benutzerdefinierten Connector selbst signieren und ihren Benutzern die Informationen (Fingerabdruck) bereitstellen, um ihn sicher zu laden.

Aus der Sicht eines Benutzers müssen Benutzer den Fingerabdruck des Entwicklers verwenden, um dem benutzerdefinierten Connector zur Verwendung sicher vertrauen und ihn laden zu können. Alternativ können Benutzer ihre Sicherheitseinstellungen verringern, um das Laden von Code zuzulassen, der nicht von Microsoft oder einem anderen Entwickler zertifiziert ist. Diese Option wird jedoch nicht empfohlen.

Zertifizierungsübersicht

Voraussetzungen

Um eine optimale Benutzererfahrung für unsere Kunden sicherzustellen, berücksichtigen wir nur Connectors, die eine Reihe von Voraussetzungen für die Zertifizierung erfüllen:

Der Connector muss für ein öffentliches Produkt vorgesehen sein.
Der Connector muss für eine erste Release-Version einen vollständigen Code enthalten. Das Programm ermöglicht häufige Iterationen und Updates. Beachten Sie, dass Microsoft keine technische Unterstützung oder Entwicklungsberatung für benutzerdefinierte Connectors bietet. Wir empfehlen, öffentliche Ressourcen wie unsere SDK-Dokumentation und das Beispiel-Repository zu nutzen. Wenn Sie weitere Unterstützung benötigen, können wir eine Liste bekannter Entwicklungsberater für benutzerdefinierte Connectors von Drittanbietern teilen, die Sie direkt, getrennt von jedem Microsoft-Programm oder einer Partnerschaft, einbeziehen möchten. Beachten Sie, dass Microsoft mit keinem dieser Berater verbunden ist und nicht für Ihre Nutzung ihrer Dienste verantwortlich ist. Microsoft stellt die Liste der Einfachheit halber und ohne jegliche Zusicherungen, Empfehlungen oder Garantien zur Verfügung. Wenden Sie sich an Ihren Microsoft-Zertifizierungskontakt, um mehr zu erfahren.
Der Entwickler muss eine Schätzung für die Nutzung bereitstellen. Wir empfehlen Entwicklern von Connectors für sehr hochwertige Produkte unsere Funktion zur Selbstsignierung von Connectors zu verwenden, um sie direkt für den Kunden bereitzustellen.
Der Connector muss den Kunden bereits direkt zur Verfügung gestellt werden, um einen Benutzerbedarf oder ein Geschäftsszenario zu erfüllen. Dieses Kriterium kann mithilfe eines Private Preview-Programms erfüllt werden, indem der fertige Connector durch Selbstsignierung direkt an Endbenutzer und Organisationen verteilt wird. Jeder Benutzer oder jede Organisation sollte in der Lage sein, Feedback zu geben und zu bestätigen, dass ein geschäftlicher Bedarf für den Connector besteht und dass der Connector seine Geschäftsanforderungen erfolgreich erfüllt.
Der Connector muss bei der erwarteten Nutzung durch die Kunden erfolgreich funktionieren.
Im Power BI-Ideenforum muss es einen Thread geben, der von Kunden geleitet wird und aus dem die Nachfrage hervorgeht, den Connector in Power BI Desktop öffentlich verfügbar zu machen. Es gibt keinen festgelegten Schwellenwert für die Interaktion. Doch je höher die Interaktion, desto höher ist die nachgewiesene Nachfrage nach dem Connector.

Diese Voraussetzungen bestehen, um sicherzustellen, dass Connectors, die sich einer Zertifizierung unterziehen, einen erheblichen Kunden- und Geschäftsbedarf haben, der nach der Zertifizierung verwendet und unterstützt wird.

Prozess- und Zeitachsen

Zertifizierte Connectors werden mit monatlichen Power BI Desktop-Versionen veröffentlicht, sodass die Fristen für jede Version ab dem jeweiligen Power BI Desktop-Veröffentlichungsdatum gelten. Die erwartete Dauer des Zertifizierungsprozesses von der Registrierung bis zur Freigabe variiert je nach Qualität und Komplexität der Connector-Übermittlung. Microsoft bietet keine spezifischen Zeitrahmengarantien im Hinblick auf die Überprüfung und Genehmigung von Connectors. Die strengen Fristen für jede Connector-Überprüfung werden in den folgenden Schritten beschrieben, Microsoft übernimmt jedoch keine Garantie für die Einhaltung dieser Fristen.

Registrierung: Benachrichtigung über die Absicht, Ihren benutzerdefinierten Connector zu zertifizieren. Dies Registrierung muss bis zum 15. des Monats erfolgen, zwei Monate vor der angestrebten Power BI-Desktop-Version.
- Für die Power BI Desktop-Version im April wäre die Frist beispielsweise der 15. Februar.
Übermittlung: Übermittlung von Connector-Dateien für die Microsoft-Überprüfung. Diese Übermittlung muss bis zum 1. des Monats vor der angestrebten Power BI Desktop-Version erfolgen.
- Für die April-Version von Power BI Desktop wäre die Frist beispielsweise der 1. März.
Technische Überprüfung: Abschluss der Connector-Dateien, Bestehen der Überprüfung und Zertifizierung von Microsoft. Diese Überprüfung muss bis zum 15. des Monats vor der geplanten Veröffentlichung von Power BI Desktop erfolgen.
- Für die April-Version von Power BI Desktop wäre die Frist beispielsweise der 15. März.

Aufgrund der Komplexität der technischen Überprüfungen und potenzieller Verzögerungen, Neuarchitekturen und Testproblemen empfehlen wir dringend, sie frühzeitig einzureichen und eine lange Vorlaufzeit für die erste Veröffentlichung und Zertifizierung einzuhalten. Wenn Sie der Meinung sind, dass es wichtig ist, dass Ihr Connector mit minimalem Mehraufwand einigen Kunden bereitgestellt wird, empfehlen wir Ihnen, ihn selbst zu signieren und auf diese Weise bereitzustellen.

Zertifizierungsanforderungen

Wir haben bestimmte Anforderungen an die Zertifizierung. Wir sind uns bewusst, dass nicht jeder Entwickler diese Anforderungen erfüllen kann, und hoffen, in Kürze einen Funktionssatz einführen zu können, der den Anforderungen der Entwickler gerecht wird.

Übermittlungsdateien (Artefakte)

Stellen Sie sicher, dass die von Ihnen übermittelten Connector-Dateien alle folgenden Elemente enthalten:

Connector-Datei (.mez)
- Die .mez-Datei sollte den Stilstandards entsprechen und entsprechend dem Produkt- oder Dienstnamen benannt werden. Es sollte keine Wörter wie „Power BI“, „Connector“ oder „API“ enthalten.
- Nennen Sie die .mez-Datei: ProductName.mez
Power BI Desktop-Datei (.pbix) zum Testen
- Wir benötigen einen Power BI-Beispielbericht (.pbix), mit dem Sie Ihren Connector testen können.
- Der Bericht sollte mindestens eine Abfrage enthalten, um jedes Element in der Navigationstabelle zu testen.
- Wenn kein festgelegtes Schema vorhanden ist (z. B. Datenbanken), muss der Bericht eine Abfrage für jeden „Typ“ der Tabelle enthalten, den der Connector verarbeiten kann.
Testkonto für Ihre Datenquelle
- Wir verwenden das Testkonto, um Ihren Connector zu testen und Fehler zu beheben.
- Stellen Sie ein dauerhaftes Testkonto bereit, damit wir dasselbe Konto zur Zertifizierung zukünftiger Updates verwenden können.
Testanweisungen
- Stellen Sie eine Dokumentation zur Verwendung des Connectors bereit, und testen Sie dessen Funktionalität.
Verknüpfungen zu externen Abhängigkeiten (z. B. ODBC-Treiber)

Features und Stil

Der Connector muss eine Reihe von Feature- und Stilregeln befolgen, um einen Benutzerfreundlichkeitsstandard zu erfüllen, der mit anderen zertifizierten Connectors konsistent ist.

Der Connector MUSS:
- das Abschnittsdokumentformat verwenden.
- eine Versionskopfzeile/-gestaltung oberhalb des Abschnittsdokuments enthalten.
- Funktionsdokumentationsmetadaten bereitstellen.
- über TestConnection-Handler verfügen.
- Benennungskonventionen (z. B DataSourceKind.FunctionName) befolgen. Es sollte keine Wörter wie „Power BI“, „Connector“ oder „API“ enthalten.
- ein Beta-Flag besitzen, das bei der ersten Version auf „true“ festgelegt ist.
FunctionName sollte für die Domäne sinnvoll sein (z. B. „Inhalt“, „Tabellen“, „Dokument“, „Datenbanken“ usw.)
Der Connector SOLLTE:
- Symbole enthalten.
- eine Navigationstabelle bereitstellen.
- Zeichenfolgen in einer resources.resx-Datei platzieren. URLs und Werte sollten im Connector-Code fest codiert sein und nicht in der Datei resources.resx platziert werden.

Sicherheit

Es gibt spezifische Sicherheitsüberlegungen, die Ihr Connector verarbeiten muss.

Wenn Extension.CurrentCredentials() verwendet wird:
- Ist die Verwendung erforderlich? Wenn ja, wohin werden die Anmeldeinformationen gesendet?
- Werden die Anforderungen garantiert über HTTPS gestellt?
  - Sie können die Funktion Hilfe zur HTTPS-Durchsetzung verwenden.
- Wenn die Anmeldeinformationen über Web.Contents() GET gesendet werden:
  - Können sie in einen POST umgewandelt werden?
  - Wenn GET erforderlich ist, MUSS der Connector den CredentialQueryString-Datensatz im Web.Contents()-Optionsdatensatz verwenden, um vertrauliche Anmeldeinformationen zu übergeben.
Wenn Diagnostics.*-Funktionen verwendet werden:
- Validieren Sie, was verfolgt wird; Daten dürfen keine personenbezogenen Informationen oder große Mengen unnötiger Daten enthalten.
- Wenn Sie in der Entwicklung eine umfangreiche Ablaufverfolgung implementiert haben, sollten Sie eine Variable oder ein Feature-Flag implementieren, das bestimmt, ob die Ablaufverfolgung aktiviert sein soll. Diese Ablaufverfolgung muss vor der Übermittlung für die Zertifizierung deaktiviert werden.
Wenn Expression.Evaluate() verwendet wird:
- Überprüfen Sie, woher der Ausdruck kommt und was er ist (d. h. er kann dynamisch Anrufe an Extension.CurrentCredentials() usw. erstellen).
- Expression sollten nicht vom Benutzer bereitgestellt werden oder Benutzereingaben entgegennehmen.
- Expression sollte nicht dynamisch sein (d. h. aus einem Webaufruf abgerufen werden).

Für Zertifizierung registrieren

Wenn Sie an der Zertifizierung Ihres benutzerdefinierten Connectors interessiert sind, stellen Sie sicher, dass Ihr Szenario und Connector die in diesem Artikel beschriebenen Voraussetzungen und Anforderungen erfüllen. Andernfalls kommt es zu Verzögerungen bei der Zertifizierung, da unser Team von Ihnen verlangt, alle Probleme oder Inkonsistenzen zu beheben, bevor mit der Zertifizierung fortgefahren wird.

Stellen Sie sicher, dass der Code Ihres Connectors vollständig ist und sowohl bei der Erstellung in Power BI Desktop als auch bei der Aktualisierung und Nutzung im Power BI-Dienst getestet wurde. Stellen Sie sicher, dass Sie die vollständige End-to-End-Aktualisierung im Power BI-Dienst mithilfe eines lokalen Datengateways getestet haben.

Füllen Sie zunächst unser Registrierungsformular aus, und ein Microsoft-Kontakt wird sich zu Beginn des Prozesses melden.

Nach der Zertifizierung

Nachdem Ihr Konnektor über Power BI Desktop und Power BI-Dienst zertifiziert und freigegeben wurde, sollten Sie einige Dinge tun, um sicherzustellen, dass Sie den aus der Produktion bereitgestellten öffentlich verfügbaren zertifizierten Konnektor ordnungsgemäß verwenden können.

Sie und Endbenutzer sollten die zertifizierte Konnektorversion in Power BI Desktop und das lokale Datengateway verwenden und vorhandene MEZ- oder PQX-Dateien (benutzerdefinierte Konnektoren) entfernen, die vor der Zertifizierung verwendet werden. Dies kann dazu führen, dass Ihr benutzerdefinierter Testkonnektor versehentlich von Power Query anstelle des neu zertifizierten Konnektors verwendet wird.
Benutzerdefinierte Konnektoren sollten nur verwendet werden, um neue Versionen des Konnektors zu testen.
Stellen Sie beim Arbeiten mit Endbenutzern und Kunden sicher, dass sie die benutzerdefinierte Konnektorversion verstehen, die vor der Zertifizierung verwendet wird. Nach Abschluss des Tests sollte sie entfernt werden und die neue zertifizierte Konnektorversion ist verfügbar.

Vorlagen-Apps (empfohlen)

Sobald Sie einen Connector zu einer Datenquelle entwickelt haben, sollten Sie darüber nachdenken, Kunden durch die Erstellung einer Vorlagen-App dabei zu helfen, schnell einsatzbereit zu sein. Eine Vorlagen-App stellt Kunden einen vordefinierten Bericht bereit, der mit ihren Daten verbunden ist, die sie bei Bedarf sofort verwenden oder anpassen können.