Tutoriel et maîtrise du langage Power Query M

Ce didacticiel explique comment implémenter avec succès un morceau de code M et résoudre les erreurs courantes dans l' éditeur Power Query . Vous apprendrez également à pratiquer et à maîtriser efficacement le langage M dans Power Query .

Table des matières

• Implémentation du langage Power Query M
  • Paramètre d'emplacement de fichier dans le langage Power Query M
• Erreurs courantes dans le langage Power Query M
  • 1. Référence cyclique
  • 2. Nom non reconnu
  • 3. Chaîne de texte
  • 4. Erreur de non-concordance de type
  • 5. Le nom n'existe pas
  • 6. Virgule symbolique
  • 7. Identificateur de jeton
  • Autres erreurs dans Power Query M Language
• Maîtrise du langage Power Query M
• Meilleures pratiques du langage Power Query M
  • 1. Barre de formule
  • 2. Bibliothèque standard
  • 3. Pratique et révision
• Conclusion

Implémentation du langage Power Query M

Le succès de l'implémentation d'un morceau de code M dépend de votre capacité à résoudre tout problème que vous rencontrez. Dans ce didacticiel, vous découvrirez les erreurs les plus courantes lorsque vous essayez de transférer du code M à partir d'un autre fichier PBIX ou lorsque vous essayez d'implémenter un morceau de code M que vous avez trouvé sur le forum.

Mais d'abord, si vous avez une question Power Query, il est important de fournir les données avec votre fichier PBIX car la résolution d'un problème peut nécessiter une modification de la configuration des données. Le fait de ne pas fournir les données entraînera une erreur de source de données de la part de la personne qui essaie de vous fournir une assistance car elle n'a pas accès à la source.

Il existe un moyen de fournir un fichier séparé, mais il ne s'applique qu'aux échantillons avec 3000 valeurs ou moins dans les colonnes et les lignes. Ainsi, si votre tableau ne dépasse pas la limite de 3 000 cellules, vous pouvez le copier dans son intégralité et le coller dans la fenêtre Créer un tableau à l'aide de l'option Saisir des données. Les données seront transférées en binaire et seront intégrées dans le fichier.

Paramètre d'emplacement de fichier dans le langage Power Query M

Une autre façon d'aider la personne qui vous fournit une assistance consiste à incorporer un paramètre d'emplacement de fichier. Ainsi, lors de la mise à jour du fichier, toutes les requêtes qu'il contient seront restaurées. Pour le démontrer, suivez ces quatre étapes.

Tout d'abord, accédez à votre explorateur Windows et copiez le chemin du fichier.

Deuxièmement, revenez à l' éditeur Power Query et sélectionnez Gérer le paramètre. Ensuite, sélectionnez Nouveau paramètre et donnez un nom au paramètre.

Troisièmement, utilisez des noms sans espaces ni caractères spéciaux pour éviter d'utiliser la notation entre guillemets lorsque vous faites référence à vos paramètres. Définissez le Type sur Texte et les Valeurs suggérées sur Liste de valeurs . Lorsque vous transmettez le fichier via le forum, vous pouvez sélectionner votre emplacement dans la liste des fichiers.

Enfin, ouvrez la fenêtre de l'éditeur avancé et remplacez le chemin du fichier codé en dur par le nom de votre paramètre.

Erreurs courantes dans le langage Power Query M

1. Référence cyclique

L'expression d'erreur ci-dessous se produit lorsque la sortie d'une requête sélectionnée est transmise à un argument de fonction d'une étape de la requête. Dans cet exemple, vous pouvez voir que le nom de la requête est passé à la fonction Table.AddColumn dans l'une de ses étapes.

Le premier argument nécessite un type de table. Dans la plupart des cas, vous constaterez qu'il fait référence à l'étape précédente dans votre code. L'étape précédente se trouve dans le volet Étapes appliquées qui se trouve sur le côté droit du volet d'aperçu.

Il n'est pas nécessaire de faire référence à l'étape précédente ; vous pouvez simplement passer une autre référence de table à cette fonction. Ainsi, dans le fichier source, recherchez le nom de l'étape dans le volet Étapes appliquées pour voir la forme de la table qui a été transmise à la fonction. Cela peut vous aider à traduire l'étape dans votre propre fichier.

2. Nom non reconnu

Cette erreur d'expression se produit lorsque le nom d'un argument de table passé à une fonction n'existe pas ou a été mal orthographié.

Gardez à l'esprit que Power Query est sensible à la casse. Dans la plupart des cas, il fera référence à l'étape précédente que vous pouvez rechercher dans le volet Étapes appliquées. Mais là encore, ce n'est pas obligatoire.

Lors du dépannage de ce type d'erreur, examinez la forme de tableau transmise à la fonction dans le fichier source et comparez-la à votre propre fichier. Assurez-vous également que les étapes n'ont pas été renommées.

3. Chaîne de texte

Cette erreur d'expression est un exemple où un argument de table qui a été transmis à une fonction a en fait été transmis en tant que chaîne de texte.

Les noms d'étape qui incluent des espaces ou des caractères spéciaux doivent être précédés du dièse ou du signe dièse entre guillemets. Les noms doivent être placés entre guillemets doubles. Lorsque vous copiez et collez des noms d'étapes, veillez toujours à sélectionner le nom complet.

4. Erreur de non-concordance de type

Une autre erreur d'expression courante est l'erreur d'incompatibilité de type.

Ces types d'erreurs ont tendance à apparaître lorsque vous commencez à apporter des modifications au code M. Dans le message d'erreur ci-dessus, une valeur datetime a été transmise à une fonction qui nécessitait un type de données date.

La solution à cette erreur consiste à convertir le type de données de la valeur avant de la transmettre en tant qu'argument à une autre fonction. Dans ce cas, vous pouvez utiliser la fonction Date.From pour convertir la valeur datetime en une valeur de date.

Il existe de nombreux types d'erreurs de non-concordance. Dans tous les cas, le système indiquera toujours le type de données requis.

5. Le nom n'existe pas

Une autre erreur d'expression courante est lorsque le nom d'une référence de colonne, passé en argument à une fonction, n'existe pas ou est mal orthographié.

Assurez-vous que les noms de colonne correspondent. Vous pouvez également essayer de changer la référence de la colonne. Si les noms de colonne correspondent et que vous obtenez toujours l'erreur, vérifiez s'il y a des espaces ou des caractères spéciaux dans le nom.

6. Virgule symbolique

Il s'agit d'une erreur de syntaxe d'expression concernant Token Comma.

Tout comme la façon dont chaque fonction prend une liste d'arguments de fonction séparés par des virgules, l'expression let prend une liste séparée par des virgules des noms et des valeurs des variables. Pour résoudre ce type d'erreur, assurez-vous que chaque étape, à l'exception de l'étape finale, comporte une virgule à la fin. Cette erreur peut également être générée par l'absence de parenthèses fermantes ou de crochets à la fin d'une fonction.

7. Identificateur de jeton

L'erreur Identificateur de jeton attendu se produit généralement lorsque le code M est copié car les guillemets se détraquent.

Pour corriger l'erreur, vous devez rechercher et remplacer tous les guillemets. Vous pouvez également utiliser une application appelée Visual Studio Code que vous pouvez télécharger gratuitement sur code.visualstudio.com .

Autres erreurs dans Power Query M Language

Voici d'autres erreurs que vous êtes susceptible de rencontrer lors de l'implémentation du code M à partir du forum.

• Jeton littéral attendu - cela signifie que la prochaine chose dans la formule devrait être une valeur, une colonne ou une fonction.
• Token RightParen Expected - cela signifie qu'un crochet fermant ou une parenthèse est censé fermer la formule
• La virgule ne peut pas précéder un RightParen - cela signifie qu'une virgule ne peut pas être directement devant une parenthèse fermante ou un crochet.
• Littéral non valide - se produit souvent lorsqu'une chaîne de texte n'a pas été fermée par un guillemet double.
• Jeton EoF attendu - se produit lorsqu'un mot-clé ou un nom de fonction non valide est utilisé.

Maîtrise du langage Power Query M

La maîtrise nécessite un engagement et un investissement à long terme. Il s'agit de faire, de s'inspirer, de pratiquer et de répéter. Mais même sans maîtrise, vous pouvez réaliser des améliorations incroyables en un laps de temps relativement court.

Si vous comprenez et êtes en mesure de mettre en pratique les concepts abordés dans ces articles, vous saurez comment corriger les erreurs lorsqu'elles se produisent. Vous pourrez également jouer avec des paramètres de fonction comme remplacer des valeurs codées en dur par des valeurs dynamiques ou écrire des fonctions M personnalisées .

Tout ce que vous avez à faire est de commencer à explorer par vous-même. Vous apprendrez le plus en vous autorisant à faire des erreurs, puis en trouvant plusieurs façons de les résoudre. Cela peut prendre du temps, mais c'est aussi très gratifiant. Une fois que vous êtes capable de le faire, vous pouvez perfectionner vos compétences.

Meilleures pratiques du langage Power Query M

1. Barre de formule

L'une des meilleures pratiques générales pour approfondir vos connaissances sur Power Query consiste à vous assurer que la barre de formule est visible à tout moment. Vous pouvez explorer la spécification du langage de formule qui décrit la structure du langage et la revoir après avoir pratiqué pendant un certain temps.

Vous pouvez partir à la chasse au trésor grâce à la référence de formule en ligne, qui répertorie toutes les fonctions et leurs spécifications. Vous pouvez les lire, copier les exemples dans la fenêtre de l'éditeur avancé et étudier les résultats.

2. Bibliothèque standard

Une autre bonne pratique consiste à explorer la bibliothèque standard à l'aide du mot-clé #shared car il existe des différences par rapport à la référence de formule en ligne. Vous pouvez également effectuer une recherche sur le Web pour d'autres contenus, tels que des exemples pratiques ou des problèmes rencontrés par d'autres.

C'est ce qu'on appelle souvent Learn by Google. Vous pouvez rechercher un nom de fonction ou un type d'opération ou de transformation, mais les résultats dépendront fortement de la manière dont vous avez défini les critères de recherche et de la manière dont les autres ont décrit leur cas.

3. Pratique et révision

La chose la plus importante est de pratiquer et de passer délibérément plus de temps à l'intérieur de l'éditeur de requête. Trouvez également un meilleur équilibre entre le temps que vous passez à apprendre DAX, les visualisations de données et le code M.

Vous pouvez également revoir votre travail passé et intégrer ces meilleures pratiques. Participez à des activités telles que de LuckyTemplates et . Tirez parti de cela en répondant aux questions sur le forum pour approfondir votre compréhension et consolider vos connaissances.

Il y aura toujours plus à apprendre et à découvrir. Fixez-vous donc un objectif que vous pouvez atteindre, comme consacrer 30 minutes par jour à votre propre étude.

Meilleures pratiques pour transformer des données dans l'éditeur de requête
Meilleures pratiques de chargement et de transformation des données

Conclusion

L'implémentation de M dans votre code nécessite de la pratique et de la maîtrise. Des erreurs peuvent se produire si une variable, une fonction ou toute autre entité est utilisée de manière incorrecte. Une fois que M est utilisé correctement, votre rapport de données fournira des résultats précieux et perspicaces.

Mélisse