SET FMTONLY (Transact-SQL)

  • Article

Retourne uniquement des métadonnées au client. Peut être utilisé pour tester le format de la réponse sans avoir à exécuter la requête.

[!REMARQUE]

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et modifiez dès que possible les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt sp_describe_first_result_set (Transact-SQL), sp_describe_undeclared_parameters (Transact-SQL), sys.dm_exec_describe_first_result_set (Transact-SQL) ou sys.dm_exec_describe_first_result_set_for_object (Transact-SQL).

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

SET FMTONLY { ON | OFF }

Notes

Aucune ligne n'est traitée ou envoyée au client lorsque l'option SET FMTONLY est configurée avec la valeur ON dans la demande.

La définition de SET FMTONLY s'effectue au moment de l'exécution, et non durant l'analyse.

Autorisations

Nécessite l'appartenance au rôle public.

Exemples

L'exemple suivant affecte la valeur ON à SET FMTONLY et exécute une instruction SELECT. Suite à cette activation, l'instruction retourne uniquement des informations sur les colonnes ; elle ne retourne aucune ligne de données.

USE AdventureWorks2012;
GO
SET FMTONLY ON;
GO
SELECT * 
FROM HumanResources.Employee;
GO
SET FMTONLY OFF;
GO

Voir aussi

Référence

Instructions SET (Transact-SQL)