Partager via

Certification du connecteur Data Factory

  • Article

Remarque

Cet article décrit les exigences et le processus de soumission d’un connecteur Data Factory à des fins de certification. Lisez l’intégralité de l’article avant de commencer le processus de certification.

Les propriétaires de sources de données qui développent un connecteur personnalisé pour leur source de données peuvent souhaiter distribuer leur connecteur personnalisé plus largement aux utilisateurs de Data Factory. Une fois qu’un connecteur personnalisé est créé, utilisé et validé par les utilisateurs finaux, le propriétaire de la source de données peut l’envoyer pour la certification Microsoft.

La certification d’un connecteur Data Factory rend le connecteur disponible publiquement, prête à l’emploi, Microsoft Fabric Data Factory et Microsoft Power BI dans les expériences suivantes :

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Modèle sémantique Microsoft Power BI (dans le service Power BI)
  • Microsoft Power BI Desktop
  • Passerelle de données locale pour Microsoft Fabric et Microsoft Power BI

Les connecteurs certifiés :

  • sont gérés par le développeur partenaire ;

  • bénéficient du support du développeur partenaire :

  • sont certifiés par Microsoft ;

  • sont distribués par Microsoft.

Nous travaillons avec des partenaires pour essayer de s’assurer qu’ils ont un support dans la maintenance, mais les problèmes clients avec le connecteur lui-même sont dirigés vers le développeur partenaire.

Remarque

Aujourd’hui, vous pouvez tirer parti du Kit de développement logiciel (SDK) Power Query pour créer un connecteur qui peut être certifié par le biais du programme de certification du connecteur Data Factory. Passez à la vue d’ensemble du Kit de développement logiciel (SDK) Power Query pour en savoir plus sur cet outil.

Vue d’ensemble de la certification

Prérequis

Pour garantir à nos clients une expérience optimale, nous prenons uniquement en compte les connecteurs qui satisfont à un ensemble de conditions préalables à la certification :

  • Le connecteur doit être destiné à un produit public.

  • Le connecteur doit être considéré comme complet du code pour une version initiale de la version. Le programme permet des itérations et mises à jour fréquentes. Microsoft ne propose ni assistance technique ni conseil en matière de développement de connecteurs personnalisés. Nous vous recommandons d’utiliser des ressources publiques comme notre documentation du kit de développement logiciel (SDK) et notre référentiel d’échantillons. Si vous avez besoin d’aide supplémentaire, nous pouvons partager une liste de consultants de développement de connecteurs personnalisés du secteur tiers connus que vous souhaiterez peut-être engager directement, séparément de n’importe quel programme ou partenariat Microsoft. Microsoft n’est affilié à aucun de ces consultants et n’est pas responsable de votre utilisation de leurs services. Microsoft fournit cette liste pour vous faciliter la tâche, mais sans aucune assurance, recommandation ou garantie. Pour en savoir plus, contactez votre contact de certification Microsoft.

  • Le développeur doit fournir une estimation de l’utilisation actuelle et future.

  • Le connecteur doit déjà être mis à la disposition des clients directement pour répondre aux besoins d’un utilisateur ou à un scénario métier. Ces critères peuvent être remplis à l’aide d’un programme Private Preview en distribuant directement le connecteur terminé aux utilisateurs finaux et aux organisations. Nous suggérons aux développeurs de connecteurs d’utiliser un mécanisme de distribution automatique et d’exécuter des tests internes de leurs propres connecteurs pour itérer sur leurs connecteurs sous un groupe contrôlé. Chaque utilisateur ou organisation doit être en mesure de formuler des commentaires, ainsi que de valider l’existence d’un besoin du connecteur et le fait que celui-ci répond à ses besoins.

  • Le connecteur doit fonctionner correctement à un niveau d’utilisation prévu par les clients.

  • Il doit y avoir un thread dans le forum Idées de structure piloté par les clients pour indiquer la demande de rendre le connecteur publiquement disponible dans Data Factory et / ou Power BI. Il n’existe pas de seuil d’engagement défini. Cependant, plus l’engagement est grand, plus la demande de connecteur est forte.

Ces prérequis existent pour s’assurer que les connecteurs soumis à la certification ont un client et une entreprise importants doivent être utilisés pour et pris en charge après la certification.

Processus et chronologies

Les connecteurs certifiés étant publiés en même temps que les publications mensuelles de Power BI Desktop, les échéances pour chaque publication sont calculées à partir de chaque date de publication de Power BI Desktop. La durée prévue du processus de certification, de l’enregistrement à la publication, varie en fonction de la qualité et de la complexité de la soumission du connecteur. Microsoft ne garantit aucun délai spécifique concernant l’examen et l’approbation des connecteurs. Les délais fermes pour chaque examen de connecteur sont décrits dans les étapes suivantes, mais Microsoft ne garantit pas le respect de ces délais.

  • Inscription : notification de l’intention de certifier votre connecteur personnalisé. Cette inscription doit être faite avant le 15 du mois, deux mois avant la publication ciblée de Power BI Desktop.

    • Par exemple, pour la version Power BI Desktop du mois d’avril, la date limite est le 15 février.

  • Soumission : soumission des fichiers du connecteur pour révision par Microsoft. Cette demande de tournoi doit être faite le premier du mois avant la publication ciblée de Power BI Desktop.

    • Par exemple, pour la version Power BI Desktop du mois d’avril, la date limite est le 1er mars.

  • Révision technique : finalisation des fichiers du connecteur, passage de la révision et de la certification par Microsoft. Elle doit être faite avant le 15 du mois précédant la publication ciblée de Power BI Desktop.

    • Par exemple, pour la version Power BI Desktop du mois d’avril, la date limite est le 15 mars.

En raison de la complexité des révisions techniques et des retards potentiels, ainsi que des aspects liés à la ré-architecture et aux tests, nous recommandons vivement d’effectuer la soumission tôt, en prévoyant un long délai pour la publication et la certification initiales.

Critères de certification

Nous avons un certain ensemble d’exigences en matière de certification. Nous sommes conscients que tous les développeurs ne peuvent pas répondre à ces exigences, et espérons introduire à brève échéance un ensemble de dispositions qui répondront aux besoins des développeurs.

Fichiers de soumission (artefacts)

Vérifiez que les fichiers de connecteur suivants sont inclus dans votre soumission :

  • Fichier du connecteur (.mez)

    • Le fichier .mez doit respecter les normes de style et porter le même nom que le produit ou service. Il ne doit pas inclure de mots tels que « Fabric », « Power BI », « Connector » ou « API ».
    • Nommez le fichier .mez : ProductName.mez

  • Fichier Power BI Desktop (.pbix) pour test

    • Nous avons besoin d’un échantillon de rapport Power BI (.pbix) pour tester votre connecteur.
    • Le rapport doit inclure au moins une requête pour tester chaque élément de votre tableau de navigation.
    • S’il n’existe aucun schéma défini (par exemple, des bases de données), le rapport doit inclure une requête pour chaque « type » de table que le connecteur peut gérer.

  • Compte de test pour votre source de données

    • Nous utilisons le compte de test pour tester votre connecteur et résoudre des problèmes éventuels.
    • Fournissez un compte de test permanent afin que nous puissions l’utiliser pour certifier de futures mises à jour.

  • Instructions de test

    • Fournissez toute la documentation nécessaire sur la façon d’utiliser le connecteur et de tester sa fonctionnalité.

  • Liens vers des dépendances externes (par exemple, pilotes ODBC)

Fonctionnalités et style

Le connecteur doit respecter un ensemble de règles sur le plan des fonctionnalités et du style de manière à offrir un niveau de convivialité cohérent avec d’autres connecteurs certifiés.

  • Le connecteur DOIT :

    • Utiliser le format de document de section.
    • Contenir un en-tête/habillage de version au-dessus du document de section.
    • Fournir des métadonnées de documentation sur la fonction.
    • Disposer d’un gestionnaire TestConnection.
    • Suivre les conventions d’affectation de noms (par exemple, DataSourceKind.FunctionName). Il ne doit pas inclure de mots tels que « Fabric », « Power BI », « Connector » ou « API ».
    • Renvoie les données sous forme de tableaux, organisés en tables avec des colonnes, comme pour une source de données relationnelle. Les formats multidimensionnels basés sur des cubes, des dimensions et des mesures ne sont pas pris en charge.
    • Ils se comportent de la même manière en mode importation et en mode DirectQuery, et renvoient des résultats identiques.
    • Avoir l’indicateur bêta défini sur True sur la publication initiale.

  • Le FunctionName doit avoir du sens pour le domaine (par exemple, « Contenu », « Tables », « Document », « Bases de données », etc.).

  • Le connecteur DEVRAIT :

    • Avoir des icônes.
    • Fournir un tableau de navigation.
    • Placer des chaînes dans un fichier resources.resx. Les URL et valeurs devraient être codées en dur dans le code du connecteur, plutôt que placées dans le fichier resources.resx.

Sécurité

Il existe des considérations de sécurité spécifiques que votre connecteur doit gérer.

  • Si la fonction Extension.CurrentCredentials() est utilisée :

    • Son utilisation est-elle requise ? Si c’est le cas, où les informations d’identification sont-elles envoyées ?
    • Est-il garanti que les requêtes seront faites via HTTPS ?
    • Si les informations d’identification sont envoyées à l’aide de Web.Contents() via une requête GET :
      • Peut-elle être transformée en requête POST ?
      • Si une requête GET est requise, le connecteur DOIT utiliser l’enregistrement CredentialQueryString dans l’enregistrement d’options Web.Contents() pour transmettre des informations d’identification sensibles.

  • Si les fonctions Diagnostics.* sont utilisées :

    • Validez ce qui est suivi. Les données ne doivent pas contenir d’informations à caractère personnel ou de grandes quantités de données inutiles.
    • Si vous avez implémenté un suivi significatif dans le développement, vous devriez implémenter une variable ou un indicateur de fonctionnalité déterminant si le suivi devrait être activé. Ce suivi doit être désactivé avant de soumettre la demande de certification.

  • Si la fonction Expression.Evaluate() est utilisée :

    • Vérifiez où l’expression provient et ce qu’elle est (autrement dit, peut construire dynamiquement des appels vers Extension.CurrentCredentials(), etc.).
    • L’Expression ne devrait pas être fournie par l’utilisateur ou prendre une entrée de celui-ci.
    • L’Expression ne devrait pas être dynamique (c’est-à-dire récupérée à partir d’un appel web).

Inscription à la certification

Si vous souhaitez poursuivre la certification de votre connecteur personnalisé, assurez-vous que votre scénario et votre connecteur sont respectent les conditions préalables et exigences décrites dans cet article. À défaut, la certification sera retardée car notre équipe vous demande de corriger tout problème ou incohérence avant de procéder à la certification.

Vérifiez que votre connecteur est complet et a été testé à la fois dans la création dans Power BI Desktop et l’actualisation et la consommation dans service Power BI. Vérifiez que vous avez testé l’actualisation complète de bout en bout dans le service Power BI en utilisant une passerelle de données locale.

Pour commencer, remplissez notre formulaire d’inscription. Un contact Microsoft vous joindra pour entamer le processus.

Après la certification

Une fois que votre connecteur est certifié et publié via les expériences Microsoft Fabric et Microsoft Power BI, vous devez effectuer quelques opérations pour vous assurer que vous pouvez utiliser correctement le connecteur certifié disponible en production.

  • Vous et les utilisateurs finaux devez utiliser la version de connecteur certifiée incluse dans les environnements avant la certification (par exemple, Power BI Desktop et la passerelle de données) et supprimer les fichiers .mez ou .pqx existants (connecteurs personnalisés) utilisés avant la certification. Dans le cas contraire, votre connecteur personnalisé de test pourrait être utilisé par Power Query par inadvertance au lieu du connecteur nouvellement certifié.
  • Les connecteurs personnalisés doivent uniquement être utilisés pour tester de nouvelles versions du connecteur.
  • Lorsque vous travaillez avec les utilisateurs finaux et les clients, assurez-vous qu’ils comprennent que la version du connecteur personnalisé utilisée dans les tests avant la certification doit être retirée une fois que les tests sont terminés et que la nouvelle version certifiée du connecteur est disponible.