Interroger à l’aide de l’éditeur de requête SQL

S'applique à :✅point de terminaison d'analytique SQL, Entrepôt et Base de données miroir dans Microsoft Fabric

Cet article explique comment utiliser l’éditeur de requête SQL dans le portail Microsoft Fabric pour écrire rapidement et efficacement des requêtes, et contient des suggestions sur la meilleure façon d’afficher les informations dont vous avez besoin.

• Vous pouvez également interroger les données dans votre entrepôt à l’aide de plusieurs outils avec une chaîne de connexion SQL.
• Vous pouvez générer des requêtes graphiquement à l’aide de l’éditeur de requête Visual.
• Vous pouvez rapidement afficher les données dans l’aperçu des données.

L’éditeur de requête SQL fournit IntelliSense, la complétion de code, la mise en évidence de la syntaxe, l’analyse syntaxique côté client et la validation. Vous pouvez exécuter des instructions Langage de définition de données (DDL), Langage de manipulation de données (DML) et Langage de contrôle de données (DCL).

L’éditeur de requête SQL dans le portail Fabric

L’éditeur de requête SQL fournit un éditeur de texte pour écrire des requêtes à l’aide de T-SQL. Pour accéder à l’éditeur de requête SQL intégré :

• Créez une requête à l’aide du bouton Nouvelle requête SQL dans le ruban.

  

• Sélectionnez la liste déroulante des modèles SQL pour créer facilement des objets T-SQL. Les modèles de code remplissent votre fenêtre de requête SQL, comme illustré dans l’image suivante.

  

Lorsque vous travaillez sur votre requête SQL, les requêtes sont automatiquement enregistrées toutes les quelques secondes. Un indicateur « enregistrement en cours » s’affiche dans l’onglet de votre requête pour indiquer que votre requête est en cours d’enregistrement.

Naviguer entre les onglets pour l’aperçu, l’interrogation et la modélisation des données

L'expérience d'aperçu, d'interrogation et de modélisation des données s'ouvre sous forme d'onglets individuels permettant le multitâche dans l'éditeur. Si vous écrivez une requête, vous pouvez basculer entre afficher un aperçu des données et afficher les relations entre les tables pour lesquelles vous écrivez la requête. Pour afficher ou fermer tous les onglets, sélectionnez l’icône située à droite de tous les onglets.

Afficher les résultats de la requête

Une fois que vous avez écrit la requête T-SQL, sélectionnez Exécuter pour l’exécuter.

L’aperçu des résultats s’affiche dans la section Résultats . Si la requête retourne plus de 10 000 lignes, l’aperçu affiche uniquement les 10 000 premières lignes. Vous pouvez rechercher une chaîne dans la grille de résultats pour filtrer les lignes qui correspondent aux critères de recherche. L’onglet Messages affiche les messages SQL retournés lors de l’exécution de la requête SQL.

La barre d’état indique l’état de la requête, la durée de l’exécution et le nombre de lignes et de colonnes retournées dans les résultats.

Pour activer l’affichage Enregistrer sous, Enregistrer sous la table, Ouvrir dans Excel, Explorez ces données (préversion) et visualisez les menus des résultats , mettez en surbrillance l’instruction SQL contenant l’instruction SELECT dans l’éditeur de requête SQL.

Enregistrer en tant que vue

Sélectionnez la requête et enregistrez votre requête en tant qu’affichage à l’aide du bouton Enregistrer sous l’affichage . Sélectionnez un nom de schéma, indiquez le nom de la vue et vérifiez l’instruction SQL avant de confirmer la création de la vue. Une fois l’affichage créé, il apparaît dans l’Explorateur.

Enregistrer en tant que table

Utilisez Enregistrer sous forme de table pour enregistrer les résultats de votre requête dans une table. Sélectionnez l’entrepôt dans lequel vous souhaitez enregistrer les résultats, sélectionnez un schéma et fournissez un nom de table pour charger les résultats dans la table à l’aide de l’instruction CREATE TABLE AS SELECT . Une fois la table créée, elle apparaît dans l’Explorateur.

Ouvrir dans Excel

Sélectionnez Ouvrir dans Excel pour ouvrir la requête T-SQL correspondante dans Excel et exécuter la requête. Vous pouvez utiliser les résultats dans Microsoft Excel sur votre ordinateur local.

Suivez ces étapes pour utiliser le fichier Excel localement :

1. Après avoir sélectionné le bouton Continuer, recherchez le fichier Excel téléchargé dans votre Explorateur de fichiers Windows, par exemple dans le dossier Téléchargements de votre navigateur.

2. Pour voir les données, sélectionnez le bouton Activer la modification dans le ruban Mode protégé suivi du bouton Activer le contenu dans le ruban Avertissement de sécurité. Une fois les deux activés, la boîte de dialogue suivante vous permet d’approuver l’exécution de la requête répertoriée.

3. Sélectionnez Exécuter.

4. Authentifiez votre compte à l’aide de l’option compte Microsoft. Sélectionnez Connecter.

Une fois que vous vous êtes connecté, vous voyez les données présentées dans la feuille de calcul.

Explorer ces données (Aperçu)

Explorer ces données (préversion) offre la possibilité d’effectuer une exploration ad hoc de vos résultats de requête. À l’aide de cette fonctionnalité, vous pouvez lancer une matrice côte à côte et une vue visuelle pour mieux comprendre les tendances ou les modèles derrière vos résultats de requête avant de vous plonger dans la création d’un rapport Power BI complet. Pour plus d’informations, consultez Explorer vos données dans le service Power BI.

Visualiser les résultats

L’option Visualiser les résultats vous permet de créer des rapports à partir des résultats de votre requête dans l’éditeur de requête SQL.

Copier

La liste déroulante Copier vous permet de copier les résultats et les noms de colonnes dans la grille de données. Vous pouvez choisir de copier des résultats avec des noms de colonnes, simplement copier les résultats ou simplement copier les noms de colonnes.

Jeux de résultats multiples

Lorsque vous exécutez plusieurs requêtes et que ces requêtes retournent plusieurs résultats, vous pouvez sélectionner la liste déroulante Résultats pour afficher des résultats individuels.

Interrogation entre entrepôts

Pour plus d’informations sur l’interrogation entre entrepôts, consultez Interrogation entre entrepôts.

Vous pouvez écrire une requête T-SQL avec la convention d’affectation de noms en trois parties pour faire référence à des objets et les joindre dans des entrepôts, par exemple :

SELECT
   emp.Employee
   ,SUM(Profit) AS TotalProfit
   ,SUM(Quantity) AS TotalQuantitySold
FROM
   [SampleWarehouse].[dbo].[DimEmployee] as emp
JOIN
   [WWI_Sample].[dbo].[FactSale] as sale
ON
   emp.EmployeeKey = sale.SalespersonKey
WHERE
   emp.IsSalesperson = 'TRUE'
GROUP BY
   emp.Employee
ORDER BY
   TotalProfit DESC;

Gérer les requêtes en cours d’exécution lors de la fermeture de l’éditeur de requête

Quand une requête est toujours en cours d’exécution et que vous fermez l’onglet de l’éditeur de requête, vous pouvez décider si la requête doit continuer à s’exécuter en arrière-plan ou être annulée.

• Oui, continuez à exécuter la requête : la requête continue à s’exécuter en arrière-plan, avec une notification toast indiquant qu’elle est en cours d’exécution. Une fois la requête terminée, une notification vous avertit afin de pouvoir revenir à la requête pour afficher les résultats.

• Non, annulez la requête : la requête est arrêtée immédiatement. Cette option est utile pour libérer des ressources ou arrêter les requêtes dont vous n’avez plus besoin.

• Souvenez-vous de ma préférence et ne vous affichez pas à nouveau : enregistre votre choix localement dans vos cookies de navigateur.

Raccourcis clavier

Les raccourcis clavier offrent un moyen rapide de naviguer et de travailler plus efficacement dans l’éditeur de requête SQL. Le tableau suivant répertorie tous les raccourcis disponibles dans Windows et macOS, dans le navigateur Edge, pour l’éditeur de requête SQL dans le portail Microsoft Fabric :

Fonction	Raccourci Windows	Raccourci macOS
Actions de l’éditeur de requête
Exécuter toutes les instructions SQL dans l’onglet requête active	Ctrl + Entrée / Maj + Entrée	Cmd + Entrée / Maj + Entrée
Fermer le panneau actif	Ctrl + Maj + F4	Commande + Maj + F4
Annuler l’exécution du script SQL	Ctrl + .	Commande + .
Rechercher une chaîne	Ctrl+F	Commande + F
Remplacer une chaîne	Ctrl+H	Commande + Option + F
Annuler	Ctrl + Z	Commande + Z
Rétablir	CTRL + Y	Commande + Maj + Z
Atteindre le mot à gauche	Ctrl + Flèche gauche	Commande + Flèche gauche
Atteindre le mot à droite	Ctrl + Flèche droite	Commande + Flèche droite
Augmentation du retrait	Onglet	Onglet
Diminution du retrait	Maj + Tab	Maj + Tab
Commentaire	Ctrl + K, Ctrl + C	Commande + K, Commande + C
Supprimer les marques de commentaire	Ctrl + K, Ctrl + U	Commande + K, Commande + U
Déplacer le curseur vers le haut	Haut	Haut
Déplacer le curseur vers le bas	Bas	Bas
Sélectionner tout	Ctrl + A	Commande + A
Expliquer la requête (Copilot)	Ctrl + Alt + E	Cmd + Option + E
Corriger la requête (Copilot)	Ctrl + Alt + F	Cmd + Option + X
Actions du ruban
Actualiser les métadonnées	Ctrl + Maj + R	Commande + Maj + R
Ouvrir les paramètres	Ctrl + Maj + X	Cmd + Maj + X
Copier la chaîne de connexion SQL	Ctrl+Maj+C	Commande + Maj + C
Ouvrir l’activité de requête	Ctrl+Maj + A	Cmd + Maj + A
Ouvrir le volet de conversation Copilot	Ctrl+ Maj + I	Commande + Maj + I
Nouveau modèle sémantique	Ctrl + Maj + M	Cmd + Maj + M
Nouvelle requête SQL	Ctrl + J	Commande + J
Nouvelle requête visuelle	Ctrl + Maj + J	Cmd + Maj + J
Actions de l’Explorateur
Développer le volet Explorateur	Ctrl + B	Commande + B
Réduire le volet de l'explorateur	Ctrl + B	Commande + B
Actions de résultats de requête
Développer les résultats	Ctrl + R	Commande + R
Réduire les résultats	Ctrl + R	Commande + R

Limites

• Dans l’éditeur de requête SQL, chaque fois que vous exécutez la requête, il ouvre une session distincte et la ferme à la fin de l’exécution. Ce comportement signifie que si vous configurez le contexte de session pour plusieurs exécutions de requête, le contexte n’est pas conservé pour l’exécution indépendante des requêtes.

• Vous pouvez exécuter des instructions Langage de définition de données (DDL), Langage de manipulation de données (DML) et Langage de contrôle de données (DCL), mais il existe des limitations pour les instructions en langage de contrôle des transactions (TCL). Dans l’éditeur de requête SQL, lorsque vous sélectionnez le bouton Exécuter, vous envoyez une requête de lot indépendante à exécuter. Chaque action Exécuter dans l’éditeur de requête SQL est une requête de lot, et une session existe uniquement par lot. Chaque exécution de code dans la même fenêtre de requête s’exécute dans un lot différent et une session différente.

  • Par exemple, lorsque vous exécutez des instructions transactionnelles indépendamment, le contexte de session n’est pas conservé. Dans la capture d’écran suivante, BEGIN TRAN est exécutée dans la première requête, mais depuis que la deuxième demande s’exécute dans une autre session, il n’existe aucune transaction à valider. L'opération de validation ou d'annulation échoue. Si le lot SQL n’inclut pas d’élément COMMIT TRAN, les modifications appliquées après BEGIN TRAN n’ont pas été validées.

  

  • L’éditeur de requête SQL ne prend pas en charge sp_set_session_context.

  • Dans l’éditeur de requête SQL, la commande SQL GO crée un lot indépendant dans une nouvelle session.

• Lorsque vous exécutez une requête SQL avec USE, vous devez envoyer la requête SQL avec USE une seule requête.

• Visualiser les résultats ne prend actuellement pas en charge les requêtes SQL avec ORDER BY clause.

• Les instructions T-SQL qui utilisent la syntaxe T-SQL OPTION ne sont pas actuellement prises en charge dans les options Explorer ces données ou visualiser les résultats en mode DirectQuery. La solution de contournement consiste à créer des visualisations dans Power BI Desktop à l’aide du mode Importation.

• Le tableau suivant récapitule le comportement attendu qui ne correspond pas à SQL Server Management Studio ou à l’extension mssql avec Visual Studio Code :

  Scénario	Pris en charge dans SSMS/ADS	Pris en charge dans l’éditeur de requête SQL dans le portail Fabric
  Utilisation des instructions SET (Transact-SQL) pour définir des propriétés pour la session	Oui	No
  Utilisation de sp_set_session_context (Transact-SQL) pour plusieurs exécutions d’instructions de lot	Oui	No
  Transactions (Transact-SQL) (sauf s’ils sont exécutés en tant que requête de lot unique)	Oui	No

Contenu associé

• Gérer des objets dans votre entrepôt de données
• Interroger à l’aide de l’éditeur de requête visuelle
• Tutoriel : Créer des requêtes entre des entrepôts avec l’éditeur de requêtes SQL

Étape suivante

Procédure : interroger l’entrepôt