Power Query framework de test sdk partie 4 - Spécification du format de test

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 effectuée de manière séquentielle pour vous assurer que votre environnement est configuré pour tester votre connecteur personnalisé.

Maintenant que vous avez configuré l’environnement, chargé les données de test et configuré la suite de tests, vous êtes prêt à vérifier votre connecteur d’extension avec la suite de tests. Avant d’exécuter les tests, vous devez comprendre différents types de fichiers et de formats dans l’infrastructure de test.

Dans cette section, vous allez :

  • Découvrez les types de formats de fichiers utilisés dans l’infrastructure de test et leurs fonctionnalités

Spécification des tests au format PQ/PQOut

Les tests de vérification des connecteurs d’extension avec l’infrastructure de test Power Query SDK sont écrits au format PQ/PQOut.

La liste suivante décrit les types de fichiers que vous devez connaître lors de l’utilisation de l’infrastructure de test Power Query SDK :

  • Testez le fichier de requête, également appelé fichier PQ, avec une extension .query.pq.
  • Fichier de sortie, également appelé fichier PQOut, avec une extension .query.pqout.
  • Fichier de requête de paramètre facultatif avec une extension .parameterquery.pq.
  • Fichier de paramètres facultatif avec une extension .settings.
  • Fichier de diagnostics facultatif avec une extension .diagnostics.

Tester le fichier de requête, également appelé fichier PQ, avec une extension .query.pq

Le fichier de requête de test (.query.pq) contient une requête de langage de formule M unique Power Query. La requête mashup est composée de variables, d’expressions et de valeurs encapsulées par une let expression avec un nom de fonction de source de données de connecteur personnalisé et des métadonnées requises à exécuter.

let
   Source = Snowflake.Databases("POWERBI.snowflakecomputing.com", "DEMO_WH"),
   Database = Source{[Name="NYCTAXIDB”, Kind="Database"]}[Data],
   Schema = Database{[Name="PUBLIC”, Kind="Schema"]}[Data],
   Table = Schema{[Name="NYCTAXIDATA”, Kind="Table"]}[Data],
   SelectColumns = Table.SelectColumns(Table, {"lpep_pickup_datetime"}),
   FirstN = Table.FirstN(SelectColumns, 1)
in
   FirstN

Fichier de sortie, également appelé fichier PQOut, avec une extension .query.pqout

Le fichier de sortie (.query.pqout) contient la sortie générée suite à l’exécution de la commande de comparaison pour un test.

L’exemple suivant montre un exemple de fichier de sortie (PQOut), par exemple, SnowflakeFirstNTests.query.pqout :

#table(type table [TIMESTAMP = datetime], {{#datetime(2014, 1, 1, 16, 0, 0.12345)}})

Fichier de requête de paramètre facultatif avec une extension .parameterquery.pq

Pour que les cas de test s’exécutent indépendamment de la source de données, la prise en charge du fichier de requête PQ/test peut être divisée en deux parties : le fichier de requête de paramètre et le fichier de requête de test.

La requête de paramètre est spécifique à la source de données et récupère les données de test de la source de données. Si vous souhaitez exécuter les tests d’un autre connecteur, vous devez mettre à jour ce fichier pour qu’il pointe vers cette source de données spécifique.

L’exemple suivant montre un exemple de fichier de requête de paramètre, par exemple Taxi.parameterquery.pq :

let
   Source = Snowflake.Databases("POWERBI.snowflakecomputing.com", "DEMO_WH"),
   Database = Source{[Name="NYCTAXIDB", Kind="Database"]}[Data],
   Schema = Database{[Name="PUBLIC", Kind="Schema"]}[Data],
   Table = Schema{[Name="NYCTAXIDATA", Kind="Table"]}[Data],
in
   Table

Lorsque le fichier de requête de paramètre facultatif est fourni, la requête de test doit uniquement contenir des transformations vers les données de test. Ces transformations sont les expressions M requises pour les tests et les rend indépendantes de la source de données. La requête de test doit ensuite déclarer une fonction lambda M qui prend les résultats de la requête de paramètre et exécute la logique de test sur les résultats d’entrée.

L’exemple suivant montre un exemple de requête de test, par exemple SnowflakeFirstNTest.query.pq :

(parameter) => 
let
   SelectColumns = Table.SelectColumns(parameter, {"lpep_pickup_datetime"}),
   FirstN = Table.FirstN(SelectColumns, 1)
in
   FirstN

Fichier de paramètres facultatif avec une extension .settings

Le fichier de paramètres facultatif est un fichier JSON qui contient les paramètres de configuration sous forme de paires clé-valeur.

L’exemple suivant montre un exemple pour un fichier de paramètres lorsque le fichier de requête de paramètre facultatif est spécifié :

{
    'Extension': 'snowflake.mez',
    'ParameterQueryFilePath': 'contoso.parameterquery.pq'
    'QueryFilePath': 'contoso.query.pq',
    'FailOnMissingOutputFile': true
}

Fichier de diagnostics facultatif avec une extension .diagnostics

Le fichier de diagnostics facultatif contient actuellement une liste de texte de commande qui est générée lorsqu’une requête M est pliée. Utilisez-le pour le test de régression du pliage des requêtes.

L’exemple suivant montre un exemple de fichier de diagnostic, par exemple SnowflakeFirstNTestSettings.diagnostics :

[
  {
    "Command": "select \"lpep_pickup_datetime\" from \"NYCTAXIDB\".\"PUBLIC\".\"NYCTAXIDATA\" LIMIT 1 OFFSET 0"
  }
]

Conclusion

Cette section vous a présenté différents formats de fichiers que vous devez connaître lors de l’utilisation de l’infrastructure de test Power Query SDK.

Dans la section suivante, vous créez des requêtes et des paramètres pour utiliser votre source de données pour votre connecteur d’extension.

Étapes suivantes

  • Last updated on