Informations de référence sur l’infrastructure 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 l’infrastructure 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.

L’infrastructure de test permet aux développeurs du Kit de développement logiciel (SDK) Power Query d’avoir accès à des tests standard et à un harnais de test 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 l’infrastructure de test du Kit de développement logiciel (SDK) Power Query ?

L’infrastructure de test du Kit de développement logiciel (SDK) Power Query est un harnais de test prêtto-go avec des tests prédéfinis pour normaliser les tests des connecteurs d’extension nouveaux et existants. Il a la possibilité d’effectuer des tests fonctionnels, de conformité et de régression à grande échelle. Il permet de répondre au besoin d’une infrastructure de test complète pour répondre aux besoins des connecteurs d’extension.

Flux de travail pour un développeur

La liste suivante est le workflow de développement logiciel (SDK) Power Query classique avec l’infrastructure 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 Kit de développement logiciel (SDK) PowerQuery pour développer un connecteur d’extension. L’extension Visual Studio Code encapsule le package NuGet Microsoft.PowerQuery.SdkTools, qui contient également un harnais de test PQTest.exe. Le harnais de test PQTest contient la nouvelle commande de comparaison pour exécuter les tests présents dans l’infrastructure de test.
2. Clonez le dépôt GitHub DataConnectors : Clonez le référentiel GitHub DataConnectors pour accéder aux données de test et aux tests contenus dans l’infrastructure de test. Pour plus d’informations sur ces tests, accédez à l’infrastructure 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, sous forme de tables vers 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 à l’infrastructure 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 de comparaison PQTest pour exécuter les tests. Pour plus d’informations, accédez à l’infrastructure 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 les formats résumé, détaillé, 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 à l’infrastructure de test du Kit de développement logiciel (SDK) Power Query, partie 7 - Guide du pipeline.

Objectifs de l’infrastructure de test

L’objectif à long terme de l’infrastructure 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 soutien des connecteurs.

Les objectifs de la version initiale de l’infrastructure de test sont de fournir :

• Utilitaire de ligne de commande facile à utiliser pour permettre aux utilisateurs de tester facilement leurs connecteurs d’extension : L’infrastructure de test introduit la commande de comparaison PQTest 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.
• Prêt-to-go ensemble initial de tests standard à exécuter pour vérifier un connecteur : L’infrastructure 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.
• Un moyen simple d’ajouter manuellement des tests pour étendre les tests : Les tests de l’infrastructure de test utilisent le nouveau format de test PQ/PQOut, ce qui simplifie le processus de création de test en réduisant 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 pliage des requêtes : L’infrastructure 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 le pliage des requêtes 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écouvrez l’infrastructure de test du Kit de développement logiciel (SDK) Power Query.
• Apprenez à configurer l’environnement de développement en installant l’infrastructure de test.
• Récupérez 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 l’infrastructure de test.
• Récupérez et exécutez la suite de tests qui contient les tests de validation de votre connecteur d’extension.
• Exécutez des tests individuels avec différentes configurations.
• Ajoutez vos propres tests pour vérifier la fonctionnalité spécifique à votre connecteur.
• Automatisez les exécutions de test en configurant un pipeline pour les tests.

Pièces

Composant	section	Détails
1	Installation	Configurez votre environnement.
2	Préparation des données	Préparation des données de test.
3	Suite de test	Extraction et compréhension de la suite de tests.
4	Spécification du format de test	Présentation des différents formats de fichiers utilisés dans l’infrastructure de test.
5	Test du connecteur	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 l’infrastructure de test.
7	Guide de configuration du pipeline	Exécution des tests dans un pipeline.