Pliage des requêtes sur des requêtes natives
Dans Power Query, vous pouvez définir une requête native et l’exécuter sur votre source de données. L’article Importer des données à partir d’une base de données à l’aide d’une base de données native explique comment effectuer ce processus avec plusieurs sources de données. Toutefois, à l’aide du processus décrit dans cet article, votre requête ne tire pas parti d’un Query Folding à partir des étapes de requête suivantes.
Cet article présente une autre méthode pour créer des requêtes natives sur votre source de données à l’aide de la fonction Value.NativeQuery et conserver le mécanisme de Query Folding actif pour les étapes suivantes de votre requête.
Remarque
Nous vous recommandons de lire la documentation sur le Query Folding et les indicateurs de Query Folding pour mieux comprendre les concepts utilisés dans cet article.
Connecteurs de données pris en charge
La méthode décrite dans les sections suivantes s’applique aux connecteurs de données suivants :
- Amazon Redshift
- Dataverse (lors de l’utilisation du calcul amélioré)
- Google BigQuery
- PostgreSQL
- SAP HANA
- Snowflake
- SQL Server
Se connecter à la cible à partir de la source de données
Remarque
Pour présenter ce processus, cet article utilise le connecteur SQL Server et l’exemple de base de données AdventureWorks2019. L’expérience peut varier du connecteur au connecteur, mais cet article présente les principes fondamentaux sur l’activation des fonctionnalités de Query Folding sur les requêtes natives pour les connecteurs pris en charge.
Lorsque vous vous connectez à la source de données, il est important que vous vous connectiez au nœud ou au niveau où vous souhaitez exécuter votre requête native. Pour l’exemple de cet article, ce nœud est le niveau de base de données à l’intérieur du serveur.
Après avoir défini les paramètres de connexion et fourni les informations d’identification de votre connexion, la boîte de dialogue de navigation de votre source de données s’ouvre. La boîte de dialogue de navigation présente tous les objets disponibles auxquels vous pouvez vous connecter.
Dans cette liste, vous devez sélectionner l’objet dans lequel la requête native est exécutée (également appelée cible). Pour cet exemple, cet objet est le niveau de base de données.
Dans la fenêtre du navigateur dans Power Query, sélectionnez et maintenez (ou cliquez avec le bouton droit) le nœud de base de données dans la fenêtre du navigateur et sélectionnez l’option Transformer les données. La sélection de cette option crée une nouvelle requête de l’affichage global de votre base de données, qui est la cible dont vous avez besoin pour exécuter votre requête native.
Une fois que votre requête arrive dans l’éditeur Power Query, seule l’étape source doit s’afficher dans le volet Étapes appliquées. Cette étape contient une table avec tous les objets disponibles dans votre base de données, comme la façon dont ils ont été affichés dans la fenêtre Navigateur.
Utiliser la fonction Value.NativeQuery
L’objectif de ce processus est d’exécuter le code SQL suivant et d’appliquer davantage de transformations avec Power Query qui peuvent être repliées vers la source.
SELECT DepartmentID, Name FROM HumanResources.Department WHERE GroupName = 'Research and Development'
La première étape a été de définir la cible correcte, qui, dans ce cas, est la base de données où le code SQL est exécuté.
Une fois qu’une étape a la cible correcte, vous pouvez sélectionner cette étape , dans ce cas, source dans les étapes appliquées, puis sélectionner le bouton fx dans la barre de formule pour ajouter une étape personnalisée. Dans cet exemple, remplacez la formule Source par la formule suivante :
Value.NativeQuery(Source, "SELECT DepartmentID, Name FROM HumanResources.Department WHERE GroupName = 'Research and Development' ", null, [EnableFolding = true])
Le composant le plus important de cette formule est l’utilisation de l’enregistrement facultatif pour le quatrième paramètre de la fonction avec le champ d’enregistrement EnableFolding défini sur true.
Remarque
Vous pouvez en savoir plus sur la fonction Value.NativeQuery à partir de l’article de documentation officiel.
Une fois que vous avez entré la formule, un avertissement s’affiche pour permettre aux requêtes natives de s’exécuter pour votre étape spécifique. Sélectionnez Continuer pour que cette étape soit évaluée.
Cette instruction SQL génère une table avec seulement trois lignes et deux colonnes.
Test Query Folding
Pour tester votre Query Folding, vous pouvez essayer d’appliquer un filtre à l’une de vos colonnes et voir si l’indicateur de Query Folding dans la section étapes appliquées affiche l’étape comme repliée. Dans ce cas, vous pouvez filtrer la colonne DepartmentID pour avoir des valeurs qui ne sont pas égales à deux.
Après avoir ajouté ce filtre, vous pouvez vérifier que les indicateurs de Query Folding affichent toujours le Query Folding à cette nouvelle étape.
Pour valider davantage la requête envoyée à la source de données, vous pouvez sélectionner et maintenir (ou cliquer avec le bouton droit) l’étape Filtrer les lignes et sélectionner l’option qui lit l’option Afficher le plan de requête pour vérifier le plan de requête pour cette étape.
Dans l’affichage du plan de requête, vous pouvez voir qu’un nœud portant le nom Value.NativeQuery possède un texte de lien hypertexte Afficher les détails. Vous pouvez sélectionner ce texte de lien hypertexte pour afficher la requête exacte envoyée à la base de données SQL Server.
La requête native est encapsulée autour d’une autre instruction SELECT pour créer une sous-requête de l’original. Power Query fait de son mieux pour créer la requête la plus optimale en fonction des transformations utilisées et de la requête native fournie.
Conseil
Pour les scénarios où vous obtenez des erreurs car le Query Folding n’était pas possible, il est recommandé d’essayer de valider vos étapes en tant que sous-requête de votre requête native d’origine pour vérifier s’il peut y avoir des conflits de syntaxe ou de contexte.