Article
09/27/2010

Interface utilisateur du Concepteur de requêtes textuel

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.

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.
**Résultats **Affiche les résultats de l'exécution de la requête au moment de la conception.

Pour obtenir des instructions détaillées sur la manière d'ouvrir le concepteur de requêtes, consultez Procédure : ouvrir un concepteur de requêtes pour une requête de dataset.

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 rapport. Seuls les types de fichiers sql et rdl sont pris en charge. Pour plus d'informations, consultez Fonctionnement des datasets de rapport.
	Exécute la requête et affiche le jeu de résultats dans le volet Résultats.
Type de commande	Sélectionnez Text, StoredProcedure ou 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. Remarque Si une procédure stockée retourne plusieurs jeux de résultats, seul le premier jeu est utilisé pour remplir le dataset. 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.

Texte de type de commande

Lorsque vous créez un dataset SQL Server, le Concepteur de rapports affiche par défaut le Concepteur de requêtes graphique. 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 : le volet Requête et le volet Résultats. L'illustration suivante présente chaque volet.

Concepteur de requêtes générique pour les requêtes de données relationnelles

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 retourne la liste des noms depuis la table Contact de la base de données AdventureWorks.

SELECT LastName FROM Person.Contact

Vous pouvez utiliser toute instruction Transact-SQL pour le texte de type de commande, y compris des instructions EXEC. La requête suivante appelle la procédure stockée uspgetEmployeeManagers de AdventureWorks et retourne la ligne hiérarchique pour l'employé dont le numéro d'identification est 1.

EXEC uspgetEmployeeManagers 1

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.

Type de commande StoredProcedure

Lorsque vous sélectionnez le Type de commandeStoredProcedure, le Concepteur de requêtes textuel présente deux volets : le volet Requête et le volet 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. La boîte de dialogue Définir les paramètres de la requête s'affiche. Entrez les valeurs des paramètres de la procédure stockée. Pour chaque paramètre de procédure stockée, un paramètre de rapport est créé.

Exemple

La requête suivante appelle la procédure stockée uspgetEmployeeManagers de AdventureWorks. Vous devez entrer une valeur pour le paramètre du numéro d'identification de l'employé lorsque vous exécutez la requête.

uspgetEmployeeManagers

Type de commande TableDirect

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