Partager via

Certification du connecteur Data Factory

  • Article

Important

Le programme de certification du connecteur subit actuellement des modifications et l’inscription de nouvelles certifications de connecteur est actuellement en attente. Cet article sera mis à jour une fois que le programme de certification du connecteur s’ouvre à nouveau pour les nouveaux partenaires. Si vous avez un connecteur certifié que vous souhaitez mettre à jour, contactez notre équipe à dataconnectors@microsoft.com pour obtenir des instructions sur la façon de soumettre une nouvelle version. La soumission est traitée chaque mois et la date de coupure des soumissions est le premier mardi de chaque mois.

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 le soumettre à la certification Microsoft.

La certification d'un connecteur Data Factory rend le connecteur disponible publiquement, prêt à l'emploi, dans 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 nos partenaires pour nous assurer qu'ils bénéficient d'une assistance en matière de maintenance, mais les problèmes des clients concernant le connecteur lui-même sont adressés au développeur du 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 finalisé pour une version initiale. 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’une assistance supplémentaire, nous pouvons vous communiquer une liste de consultants tiers connus pour le développement de connecteurs personnalisés que vous pouvez contacter directement, en dehors de tout programme ou partenariat avec 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 en préversion 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 d'autodistribution et d'effectuer des tests internes de leurs propres connecteurs afin d'itérer sur leurs connecteurs au sein d'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 fil de discussion dans le forum Fabric Ideas animé par des 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 conditions préalables permettent de s'assurer que les connecteurs en cours de certification répondent à des besoins importants des clients et des entreprises et qu'ils sont utilisés et pris en charge après la certification.

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.

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 », « Connecteur » 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 :

    • Valider l'origine de l'expression et sa nature (c'est-à-dire, si elle peut construire dynamiquement des appels à 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).

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.