Freigeben über

Data Factory-Connectorzertifizierung

  • Artikel

Wichtig

Am Connectorzertifizierungsprogramm werden derzeit Änderungen vorgenommen, und die Registrierung für neue Connectorzertifizierungen ist derzeit pausiert. Wir planen, diesen Registrierungsprozess im ersten Quartal des Kalenderjahres 2025 wieder zu aktivieren. Wenn Sie über einen zertifizierten Connector verfügen, den Sie aktualisieren möchten, wenden Sie sich unter dataconnectors@microsoft.com an unser Team, um Anweisungen zum Übermitteln einer neuen Version zu erhalten.

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

Durch das Zertifizieren eines Data Factory-Connectors wird der Connector in Microsoft Fabric Data Factory und Microsoft Power BI öffentlich verfügbar und sofort einsatzbereit, und zwar in den folgenden Umgebungen:

  • 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 Unterstützung bei der Wartung erhalten. Kundenprobleme mit dem Connector selbst werden jedoch an den Partnerentwickler weitergeleitet.

Hinweis

Heute können Sie das Power Query-SDK nutzen, um einen Connector zu erstellen, der über das Data Factory-Connectorzertifizierungsprogramm zertifiziert werden kann. Wechseln Sie zur Übersicht über das Power Query-SDK, 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 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. 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 Ihnen eine Liste bekannter Entwicklungsberater für benutzerdefinierte Connectors von Drittanbietern zur Verfügung stellen, die Sie auf Wunsch direkt, getrennt von jedem Microsoft-Programm oder einer Partnerschaft, einbeziehen können. 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. Wenden Sie sich an Ihren Ansprechpartner für die Microsoft-Zertifizierung, um mehr zu erfahren.

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

  • Der Connector muss den Kunden bereits direkt zur Verfügung gestellt werden, um eine Benutzeranforderung oder ein Geschäftsszenario zu erfüllen. Dieses Kriterium kann mithilfe eines Vorschauprogramms 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 in 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 bei der erwarteten Nutzung durch die Kunden erfolgreich funktionieren.

  • Im Fabric-Ideenforum muss es einen Thread geben, der von Kunden geleitet wird und aus dem die Nachfrage hervorgeht, den Connector in Data Factory und/oder Power BI ö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 sollen sicherstellen, dass für Connectors, die einer Zertifizierung unterzogen werden, ein erheblicher Kunden- und Geschäftsbedarf für die Verwendung und Unterstützung nach der Zertifizierung besteht.

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.

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 sein.
    • 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, woher der Ausdruck kommt und was er ist (d. h. er kann dynamisch Anrufe an Extension.CurrentCredentials() usw. erstellen).
    • Expression sollte nicht vom Benutzer bereitgestellt werden oder Benutzereingaben entgegennehmen.
    • Expression sollte nicht dynamisch sein (d. h. aus einem Webaufruf abgerufen werden).

Nach der Zertifizierung

Nachdem Ihr Connector über Microsoft Fabric- und Microsoft Power BI-Umgebungen zertifiziert und freigegeben wurde, sollten Sie einige Schritte ausführen, um sicherzustellen, dass Sie den in der Produktion bereitgestellten öffentlich verfügbaren zertifizierten Connector ordnungsgemäß verwenden können.

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