Développer un connecteur à l’aide du Kit de développement logiciel (SDK) Power Query
Le Power Query SDK est un jeu d’outils conçus pour vous aider à créer des connecteurs Power Query. Ces connecteurs sont souvent appelés connecteurs personnalisés ou extensions Power Query.
Les connecteurs personnalisés vous permettent de créer de nouvelles sources de données ou de personnaliser et d’étendre une source existante. Les cas d’utilisation courants sont les suivants :
- Création d’une vue conviviale pour une API REST.
- Fourniture d’une personnalisation pour une source prise en charge par Power Query avec un connecteur existant (par exemple, un service OData ou un pilote ODBC).
- Implémentation du flux d’authentification OAuth v2 pour une offre SaaS.
- Exposition d’une vue limitée ou filtrée de votre source de données pour faciliter l’utilisation.
- Activation de DirectQuery pour une source de données à l’aide d’un pilote ODBC.
Installez le nouveau Kit de développement logiciel (SDK) Power Query Visual Studio Code à partir de la section Visual Studio Code de Visual Studio Marketplace. Sélectionnez Installer pour installer le SDK.
Les sections suivantes décrivent, à un niveau élevé, le processus le plus courant pour créer un connecteur Power Query à l’aide du SDK.
Lors de la création d’un nouvel espace de travail (Kit de développement logiciel (SDK) Power Query Visual Studio Code), vous commencez par les fichiers cœurs suivants :
- Fichier de définition du connecteur (<connectorName.pq>)
- Un fichier de requête (<connectorName>.query.pq)
- Fichier de ressource de chaîne (resources.resx)
- Fichiers PNG de différentes tailles utilisées pour créer des icônes
Votre fichier de définition de connecteur commence par une description de source de données vide. Vous pouvez en savoir plus sur une source de données dans le contexte du Power Query SDK à partir de l’article sur la gestion de l’accès aux données.
Le Kit de développement logiciel (SDK) Power Query fournit des fonctionnalités d’exécution de requête de base qui vous permettent de tester votre extension sans devoir passer à une autre application client. Vous pouvez également tester votre connecteur dans une application telle que :
Outre le fichier d’extension, les projets de connecteur de données peuvent avoir un fichier de requête (nom.query.pq). Ce fichier peut être utilisé pour exécuter des requêtes de test dans Visual Studio Code. L’évaluation de la requête inclura automatiquement votre code d’extension, sans avoir à enregistrer votre fichier .pqx, ce qui vous permettra d’appeler ou de tester toutes les fonctions partagées dans votre code d’extension.
Le fichier de requête peut contenir une expression unique (par exemple, HelloWorld.Contents()
), une expression let
(comme ce que Power Query générerait) ou un document de section.
La création de votre projet produit votre fichier ou fichier d’extension .mez. Les extensions Power Query sont regroupées dans un fichier ZIP avec une extension de fichier .mez.
Les extensions sont définies dans un document de section M. Un document de section présente un format légèrement différent de celui des documents de requête générés dans Power Query. Le code que vous importez à partir de Power Query nécessite généralement une modification pour tenir dans un document de section, mais cette modification est mineure. Les différences que vous devez connaître concernant les documents de section sont les suivantes :
- Ils commencent par une déclaration de section (par exemple,
section HelloWorld;
). - Chaque expression se termine par un point-virgule (par exemple,
a = 1;
oub = let c = 1 + 2 in c;
). - Toutes les fonctions et variables sont locales au document de section, sauf si elles sont marquées comme partagées. Les fonctions partagées deviennent visibles par d’autres requêtes/fonctions, et peuvent être considérées comme des exportations de votre extension (autrement dit, elles deviennent appelables à partir de Power Query).
Pour plus d’informations sur les documents de section M, consultez Spécification du langage M.
Vous avez deux possibilités pour distribuer votre connecteur :
- Libre-service
- Certification des connecteurs
Un mécanisme en libre-service vous permettant d'appliquer des connecteurs personnalisés Power Query dans les expériences de produits applicables
Une fois votre connecteur créé, vous pouvez envoyer ce fichier comme vous le souhaitez à vos utilisateurs et ils peuvent utiliser le connecteur dans les expériences de produits applicables tels que Microsoft Power BI.
Vous pouvez utiliser votre propre connecteur personnalisé dans Microsoft Power BI Desktop et Microsoft Power BI Service pour les modèles sémantiques pour l'actualisation et la connectivité dans le cloud.
Les connecteurs Power Query peuvent être chargés dans trois expériences :
- Passerelle de données locale : Votre connecteur peut être chargé via la passerelle pour être utilisé dans les services Microsoft Fabric et Microsoft Power BI
- Power Query Online : au sein d'expériences telles que Power BI Datamarts, Fabric Dataflow Gen2, et bien d'autres
- Power Query Desktop : au sein d’expériences comme Power BI Desktop.
Pour en savoir plus sur l'utilisation de votre connecteur personnalisé pour l'autodistribution, consultez les articles ci-dessous :
- Charger un connecteur personnalisé Power Query dans Power BI Desktop
- Activer et utiliser des connecteurs personnalisés dans le service Power BI
Le programme de certification des connecteurs Data Factory vous permet de soumettre votre connecteur à Microsoft pour certification. Microsoft se charge alors de publier et de distribuer votre connecteur dans Microsoft Fabric et Microsoft Power BI pour les produits et expériences applicables :
- Power Query Desktop : Microsoft Power BI Desktop.
- Power Query Online : Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1, et d’autres
- Passerelle de données locale : Pour Microsoft Fabric et Microsoft Power BI qui utilisent une passerelle pour l'actualisation ou la connectivité authentifiée.
En savoir plus sur le programme de certification de Connecteur Data Factory.