Informations de référence sur le cadre de test du Kit de développement logiciel (SDK) Power Query

Cette référence en plusieurs parties couvre l’installation et l’exécution d’une suite standard de tests pour les développeurs de connecteurs Power Query. La référence est destinée à être suivie de manière séquentielle pour vous assurer que votre environnement est configuré pour tester votre connecteur d’extension.

Cette référence utilise le cadre de test du Kit de développement logiciel (SDK) Power Query, une suite de tests standardisée et une version modifiée des données d’enregistrement de voyage vert NewYork City Taxi & Limousine Commission (TLC). Les sections suivantes décrivent les étapes de configuration de votre environnement pour valider votre connecteur d’extension.

Le cadre de test permet aux développeurs du Kit de développement logiciel (SDK) Power Query d’avoir accès à des tests standard et à un faisceau de tests pour vérifier les fonctionnalités de DirectQuery (DQ) d’un connecteur d’extension. Avec cette nouvelle fonctionnalité, les développeurs ont un moyen standard de vérifier les connecteurs et une plateforme pour ajouter des tests personnalisés. Nous prévoyons cela comme première étape pour améliorer la productivité du flux de travail de test fourni par le Kit de développement logiciel (SDK) Power Query.

Qu’est-ce que le cadre de test du Kit de développement logiciel (SDK) Power Query ?

Le cadre de test du Kit de développement logiciel (SDK) Power Query est un faisceau de tests prêt à l’utilisation avec des tests prédéfinis pour normaliser les tests des connecteurs d’extension nouveaux et existants. Il a la capacité à réaliser des tests fonctionnels, de conformité et de régression à grande échelle. Il permet de répondre au besoin d’un cadre de test complète pour répondre aux besoins des connecteurs d’extension.

un flux de travail pour les développeurs

La liste suivante est le flux de travail de développement logiciel (SDK) Power Query classique avec le cadre de test :

1. Installez l’extension Visual Studio Code du Kit de développement logiciel (SDK) Power Query : un développeur de connecteurs doit installer l’extension Visual Studio Code du SDK PowerQuery pour le développement d’un connecteur d’extension. L’extension Visual Studio Code encapsule le package NuGet Microsoft.PowerQuery.SdkTools, qui contient également un faisceau de tests PQTest.exe. Le faisceau de tests PQTest contient la nouvelle commande comparer pour exécuter les tests présents dans le cadre du test.
2. Clonez les données Connecter ors GitHub Repo : clonez le référentiel GitHub Data Connecter pour accéder aux données de test et aux tests contenus dans le cadre de test. Pour plus d’informations sur ces tests, accédez au cadre de test du Kit de développement logiciel (SDK) PowerQuery, partie 3 - Suite de tests.
3. Chargez les données de test dans la source de données : le développeur du connecteur doit charger les données de test, composées de deux fichiers CSV, en tant que tables de leur source de données, ce qui garantit que le schéma correspond au fichier de schéma SQL fourni. Pour plus d’informations, accédez au cadre de test du Kit de développement logiciel (SDK) Power Query, partie 2 - Données de test.
4. Configurez et exécutez les tests : le développeur du connecteur doit ensuite exécuter les tests à l’aide de l’utilitaire PowerShell RunPQSDKTestSuites fourni, qui utilise la commande PQTest comparer pour exécuter les tests. Pour plus d’informations, accédez au cadre de test du Kit de développement logiciel (SDK) Power Query partie 5 - Test de votre connecteur d’extension.
5. Création de rapports & CI/CD : le rapport de test par défaut est généré dans la console et il existe également des options pour générer le rapport dans des formats résumés, détaillés, TRX et JSON. Le format TRX (fichier de résultats de test Visual Studio) est utile pour afficher les résultats lorsqu’ils sont exécutés dans le cadre d’un pipeline. Pour plus d’informations, accédez au cadre de test du Kit de développement logiciel (SDK) Power Query, partie 7 - Guide du pipeline.

Objectifs du cadre de test

L’objectif à long terme du cadre de test du SDK Power Query est de fournir une solution de test robuste intégrée au Kit de développement logiciel (SDK) Visual Studio Code pour tester les connecteurs d’extension. Il doit considérablement améliorer l’expérience du développeur pour le développement des connecteurs. Il devrait également amener la normalisation à des pratiques de test plutôt fragmentées, augmentant finalement la barre de qualité et réduisant les efforts de maintien en état des connecteurs. Nous prévoyons également le cadre de test pour se connecter au processus de certification du connecteur et améliorer l’expérience des partenaires.

Les objectifs de la version initiale du cadre de test sont de fournir :

• Utilitaire de ligne de commande facile à utiliser pour les utilisateurs afin de tester facilement leurs connecteurs d’extension : le cadre de test introduit la commande PQTest comparer la commande avec des options intuitives pour exécuter les tests. Il fournit également l’utilitaire PowerShell RunPQSDKTestSuites, qui permet également de tester par lots. Des configurations simples et automatiques sont fournies pour configurer et exécuter les tests.
• Ensemble initial de tests standard prêts à l’utilisation à exécuter pour vérifier un connecteur : le cadre de test fournit une suite de tests d’intégrité pour valider le schéma, le nombre de lignes et les données des tables de test. Il fournit également une suite de tests standard pour vérifier les types de données, mathématiques, date, heure, fonctions de texte, opérateurs et jointures.
• Méthode simple d’ajout manuel de tests pour étendre les tests : les tests du cadre de test utilisent le nouveau format de test PQ/PQOut, ce qui simplifie le processus de création de test en minimisant les configurations nécessaires. Les développeurs de connecteurs peuvent ensuite se concentrer sur la création de la requête M pour leur test. Chaque test est modulaire et séparé en fichiers individuels pour simplifier la maintenance. La sortie attendue est également générée lors de la première exécution.
• Possibilité de tester les tests de Query Folding : le cadre de test peut également générer les diagnostics d’un connecteur. Actuellement, la fonctionnalité de diagnostic est limitée à la génération de requêtes SQL pendant Query Folding pour un connecteur ODBC. Cette fonctionnalité sera étendue à d’autres diagnostics à l’avenir.

Vue d'ensemble du guide de référence

Dans ce guide, vous allez :

• Découvrir le cadre de test du Kit de développement logiciel (SDK) Power Query.
• Apprendre à configurer l’environnement de développement en installant le cadre de test.
• Récupérer le jeu de données utilisé dans la suite de tests et chargez-le dans une source de données basée sur votre connecteur d’extension.
• Comprendre les spécifications de format de test qui sont, les formats de fichier et leurs fonctionnalités dans le cadre de test.
• Récupérer et exécutez la suite de tests qui contient les tests de validation de votre connecteur d’extension.
• Exécuter des tests individuels avec différentes configurations.
• Ajouter vos propres tests pour vérifier la fonctionnalité spécifique à votre connecteur.
• Automatiser les exécutions de test en configurant un pipeline pour les tests.

Éléments

Élément	section	Détails
1	Programme d’installation	Configurez votre environnement.
2	Préparation des données	Préparation des données de test.
3	Suite de tests	Extraction et compréhension de la suite de tests.
4	Spécification du format de test	Compréhension des différents formats de fichiers utilisés dans le cadre de test.
5	Test des connecteurs	Test de votre connecteur d’extension.
6	Ajout de tests	Ajout de vos propres tests et compréhension des différentes options et configurations dans le cadre de test.
7	Guide de configuration du pipeline	Exécution des tests dans un pipeline.