Freigeben über

Data Factory Connector-Zertifizierung

  • Artikel

Hinweis

In diesem Artikel werden die Anforderungen und Prozesse zum Übermitteln eines Data Factory-Connectors für die Zertifizierung beschrieben. Lesen Sie den gesamten Artikel sorgfältig durch, bevor Sie mit dem Zertifizierungsprozess beginnen.

Datenquellenbesitzer, die einen benutzerdefinierten Connector für ihre Datenquelle entwickeln, möchten möglicherweise ihren benutzerdefinierten Connector breiter an Data Factory-Benutzer verteilen. Nachdem ein benutzerdefinierter Connector erstellt, verwendet und von Endbenutzern überprüft wurde, kann der Datenquellenbesitzer ihn zur Microsoft-Zertifizierung übermitteln.

Durch das Zertifizieren eines Data Factory-Connectors wird der Connector in den folgenden Umgebungen öffentlich, sofort einsatzbereit, Microsoft Fabric Data Factory und Microsoft Power BI zur Verfügung gestellt:

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Microsoft Power BI-Semantikmodell (im Power BI-Dienst)
  • Microsoft Power BI Desktop
  • Lokales Datengateway für Microsoft Fabric und Microsoft Power BI

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 Support bei der Wartung haben, aber Kundenprobleme mit dem Connector selbst werden an den Partnerentwickler weitergeleitet.

Hinweis

Heute können Sie das Power Query SDK nutzen, um einen Connector zu erstellen, der über das Data Factory-Connector-Zertifizierungsprogramm zertifiziert werden kann. Navigieren Sie zur Power Query SDK-Übersicht , um mehr über dieses Tool zu erfahren.

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 Verbinder muss für ein öffentliches Produkt sein.

  • Der Connector muss als codevervollständigen für eine erste Releaseversion betrachtet werden. Das Programm ermöglicht häufige Iterationen und Updates. Microsoft bietet keine technische Unterstützung oder Entwicklungsberatung für benutzerdefinierte Connectors. 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 benutzerdefinierter Connector-Entwicklungsberater von Drittanbietern teilen, die Sie möglicherweise direkt nutzen möchten, unabhängig von jedem Microsoft-Programm oder jeder Partnerschaft. Microsoft ist mit keinem dieser Berater verbunden und ist nicht für Ihre Nutzung ihrer Dienste verantwortlich. Microsoft stellt die Liste der Einfachheit halber und ohne jegliche Zusicherungen, Empfehlungen oder Garantien zur Verfügung. Um mehr zu erfahren, wenden Sie sich an Ihren Microsoft-Zertifizierungskontakt.

  • Der Entwickler muss eine Schätzung für die aktuelle und zukünftige Nutzung bereitstellen.

  • Der Connector muss kunden bereits direkt zur Verfügung gestellt werden, um ein Benutzerbedarfs- oder Geschäftsszenario zu erfüllen. Diese Kriterien können mit einem privaten Vorschauprogramm erfüllt werden, indem der fertige Connector direkt an Endbenutzer und Organisationen verteilt wird. Wir empfehlen Entwicklern von Connectors, einen Selbstverteilungsmechanismus zu verwenden und interne Tests ihrer eigenen Connectors auszuführen, um ihre Connectors unter einer kontrollierten Gruppe zu durchlaufen. 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 erfolgreich auf einem erwarteten Nutzungsgrad von Kunden ausgeführt werden.

  • Es muss ein Thread im Fabric Ideas-Forum vorhanden sein, das von Kunden gesteuert wird, um die Nachfrage anzugeben, dass der Connector in Data Factory und / oder Power BI öffentlich verfügbar ist. 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 einer Zertifizierung unterzogen werden, erhebliche Kunden- und Geschäftsanforderungen haben, für die nach der Zertifizierung verwendet und unterstützt werden müssen.

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 Ersten 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.

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 folgenden Connectordateien in Ihrer Übermittlung enthalten sind:

  • Connector-Datei (.mez)

    • Die .mez-Datei sollte den Stilstandards entsprechen und entsprechend dem Produkt- oder Dienstnamen benannt werden. Es sollte keine Wörter wie "Fabric", "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 Setschema vorhanden ist (z. B. Datenbanken), muss der Bericht eine Abfrage für jeden "Tabellentyp" enthalten, den der Connector behandeln 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 "Fabric", "Power BI", "Connector" oder "API" enthalten.
    • Es werden Daten in Tabellenformat zurückgegeben, angeordnet in Tabellen mit Spalten, wie bei einer relationale Datenquelle. Mehrdimensionale Formate, die auf Cubes, Dimensionen und Measures basieren, werden nicht unterstützt.
    • Gleiches Verhalten im Import- und DirectQuery-Modus. Es werden identische Ergebnisse zurückgegeben.
    • 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?
    • 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, wo der Ausdruck stammt und was er ist (d. r. kann Aufrufe Extension.CurrentCredentials()dynamisch erstellen usw.).
    • Expression sollte 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 Connector vollständig ist und sowohl in Power BI Desktop als auch beim Aktualisieren und Verbrauch in 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 Connector über Microsoft Fabric- und Microsoft Power BI-Oberflächen zertifiziert und freigegeben wurde, sollten Sie einige Dinge tun, um sicherzustellen, dass Sie den öffentlich bereitgestellten öffentlich verfügbaren zertifizierten Connector ordnungsgemäß verwenden können.

  • Sie und Endbenutzer sollten die in Umgebungen enthaltene zertifizierte Connectorversion vor der Zertifizierung (z. B. Power BI Desktop und das Datengateway) verwenden und vorhandene MEZ- oder PQX-Dateien (benutzerdefinierte Connectors) 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.