Partager via


Interface utilisateur du Concepteur de requêtes textuel (Générateur de rapports)

Utilisez le Concepteur de requêtes textuel pour spécifier une requête à l'aide du langage de requête pris en charge par la source de données, exécuter la requête et afficher les résultats au moment de la conception. Vous pouvez spécifier plusieurs instructions Transact-SQL, une syntaxe de requête ou de commande pour les extensions pour le traitement des données personnalisées et des requêtes spécifiées en tant qu’expressions. Comme le Concepteur de requêtes textuel n'effectue pas de prétraitement de la requête et peut accepter tout type de syntaxe de requête, il s'agit de l'outil du Concepteur de requêtes par défaut pour de nombreux types de sources de données.

Important

Les utilisateurs accèdent aux sources de données lorsqu'ils créent et exécutent des requêtes. Vous devez accorder des autorisations minimales sur les sources de données, telles que des autorisations en lecture seule.

Le Concepteur de requêtes textuel affiche une barre d'outils et les deux volets suivants :

  • Requête Affiche le texte de la requête, le nom de la table ou celui de la procédure stockée, en fonction du type de requête. Les types de requêtes ne sont pas tous disponibles pour tous les types de sources. Par exemple, le nom de table n'est pris en charge que pour le type de source de données OLE DB.

  • Résultats Affiche les résultats de l'exécution de la requête au moment de la conception.

Barre d'outils du Concepteur de requêtes textuel

Le Concepteur de requêtes textuel fournit une barre d'outils unique pour tous les types de commandes. Le tableau suivant répertorie chaque bouton de la barre d'outils et décrit sa fonction.

Bouton Description
Modifier en tant que texte Bascule entre le Concepteur de requêtes textuel et le concepteur de requêtes graphique. Les types de sources de données ne prennent pas tous en charge les concepteurs de requêtes graphiques.
Importer Importe une requête existante à partir d'un fichier ou d'un rapport. Seuls les types de fichiers sql et rdl sont pris en charge.
Run the query Exécute la requête et affiche le jeu de résultats dans le volet Résultats.
Type de commande Sélectionnez Text, StoredProcedureou TableDirect. Si une procédure stockée comporte des paramètres, la boîte de dialogue Définir les paramètres de la requête s'affiche lorsque vous cliquez sur Exécuter dans la barre d'outils, et vous pouvez spécifier les valeurs souhaitées. La prise en charge du type de commande varie en fonction du type de source de données. Par exemple, seuls OLE DB et ODBC prennent en charge TableDirect.

Remarque : Si une procédure stockée retourne plusieurs jeux de résultats, seul le premier jeu est utilisé pour remplir le dataset.

Texte de type de commande

Lorsque vous créez un dataset SQL Server , le Concepteur de requêtes relationnelles s'ouvre par défaut. Pour basculer vers le concepteur de requêtes textuel, cliquez sur le bouton bascule Modifier en tant que texte dans la barre d’outils. Le concepteur de requêtes textuel présente deux volets : Requête et Résultats. L'illustration suivante présente chaque volet.

Generic query designer, for relational data query

Le tableau ci-dessous décrit la fonction de chaque volet.

Volet Fonction
Requête Affiche le texte de la requête Transact-SQL. Ce volet permet d’écrire ou de modifier une requête Transact-SQL.
Résultats Affiche les résultats de la requête. Pour exécuter la requête, cliquez avec le bouton droit dans un volet et cliquez sur Exécuter, ou cliquez sur le bouton Exécuter dans la barre d’outils.

Exemple

La requête suivante renvoie la liste des noms à partir de la table ContactType de la base de données AdventureWorks2022 pour le schéma Person.

SELECT Name FROM Person.ContactType  

Lorsque vous cliquez sur Exécuter dans la barre d'outils, la commande du volet Requête s'exécute et les résultats s'affichent dans le volet Résultat . Le jeu de résultats affiche une liste de 20 types de contacts, par exemple Owner ou Sales Agent.

Type de commande StoredProcedure

Quand vous sélectionnez le Type de commande StoredProcedure, le concepteur de requêtes textuel présente deux volets : Requête et Résultats. Entrez le nom de la procédure stockée dans le volet Requête, puis cliquez sur Exécuter dans la barre d'outils. Si les procédures stockées utilisent des paramètres, la boîte de dialogue Définir les paramètres de la requête s'ouvre. Entrez les valeurs des paramètres de la procédure stockée. Pour chaque paramètre d'entrée de procédure stockée, un paramètre de rapport est créé.

La figure suivante illustre les volets Résultats et Requête lorsque vous exécutez une procédure stockée. Dans ce cas, les paramètres d'entrée sont des constantes.

Stored procedure in text-based query designer

Le tableau ci-dessous décrit la fonction de chaque volet.

Volet Fonction
Requête Affiche le nom de la procédure stockée et tout paramètres d'entrée.
Résultats Affiche les résultats de la requête. Pour exécuter la requête, cliquez avec le bouton droit dans un volet et cliquez sur Exécuter, ou cliquez sur le bouton Exécuter dans la barre d’outils.

Exemple

La requête ci-après appelle la procédure stockée AdventureWorks2022 uspGetWhereUsedProductID. Vous devez entrer une valeur pour le paramètre du numéro d'identification de produit lorsque vous exécutez la requête.

uspGetWhereUsedProductID  

Cliquez sur le bouton Exécuter ( ! ). Lorsque vous êtes invité à indiquer les paramètres de la requête, utilisez le tableau suivant pour entrer les valeurs.

Paramètre Valeur
@StartProductID 820
@CheckDate 20010115

Pour la date spécifiée, le jeu de résultats affiche une liste de 13 identificateurs de produits ayant utilisé le numéro de composant spécifié.

Type de commande TableDirect

Quand vous sélectionnez le Type de commande TableDirect, le concepteur de requêtes textuel présente deux volets : Requête et Résultats. Lorsque vous entrez une table et cliquez sur le bouton Exécuter , toutes les colonnes pour cette table sont retournées.

Exemple

Pour le type de source de données OLE DB, la requête de jeu de données suivante retourne un jeu de résultats pour tous les types de contacts dans la base de données AdventureWorks2022.

Person.ContactType

Lorsque vous entrez le nom de table Person.ContactType, cela revient à créer l’instruction Transact-SQLSELECT * FROM Person.ContactType.

Voir aussi

Interface utilisateur du Concepteur de requêtes relationnelles (Générateur de rapports)
Outils de création de requête (SSRS)