sys.fn_get_sql (Transact-SQL)
Renvoie le texte de l'instruction SQL pour le handle SQL spécifié.
Important
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 prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez sys.dm_exec_sql_text à la place. Pour plus d'informations, consultez sys.dm_exec_sql_text (Transact-SQL).
.gif "Icône Lien de rubrique")
Conventions de la syntaxe Transact-SQL
Syntaxe
sys.fn_get_sql ( SqlHandle )
Arguments
- SqlHandle
Valeur du handle. SqlHandle est de type varbinary(64) et n'a pas de valeur par défaut.
Tables retournées
Nom de la colonne |
Type de données |
Description |
|---|---|---|
dbid |
smallint |
ID de la base de données. Pour les instructions SQL ad hoc et préparées, l'ID de la base de données où les instructions ont été compilées. |
objectid |
int |
Identificateur de l'objet de base de données. NULL pour les instructions SQL ad hoc. |
number |
smallint |
Indique le numéro du groupe, si les procédures sont groupées. 0 = les entrées ne sont pas des procédures. NULL = instructions SQL ad hoc. |
encrypted |
bit |
Indique si l'objet est chiffré. 0 = Non chiffré 1 = Chiffré |
text |
text |
Texte de l'instruction SQL. NULL pour les objets chiffrés. |
Notes
Vous pouvez obtenir un handle SQL valide à partir de la colonne sql_handle de la vue de gestion dynamique sys.dm_exec_requests (Transact-SQL).
Si vous passez un handle qui n'existe plus dans le cache, fn_get_sql retourne un jeu de résultats vide. Si vous passez un handle qui n'est pas valide, le lot s'arrête et un message d'erreur s'affiche.
Le Moteur de base de données SQL Server ne peut pas mettre en cache certaines instructions Transact-SQL, telles que les instructions de copie en bloc et les instructions avec des chaînes littérales de plus de 8 Ko. Les handles de ces instructions ne peuvent pas être récupérés avec fn_get_sql.
La colonne text du jeu de résultats est filtrée pour tout texte susceptible de contenir des mots de passe. Pour plus d'informations sur la sécurité liée aux procédures stockées non contrôlées, consultez Filtrer une trace.
La fonction fn_get_sql renvoie des informations similaires à celles de la commande DBCC INPUTBUFFER. Les exemples suivants montrent quand vous pouvez utiliser la fonction fn_get_sql parce que DBCC INPUTBUFFER ne peut pas l'être :
lorsque des événements contiennent plus de 255 caractères ;
lorsque vous devez renvoyer le niveau d'imbrication actuel le plus élevé d'une procédure stockée. Imaginons par exemple deux procédures stockées appelées sp_1 et sp_2. Si sp_1 appelle sp_2 et que vous obtenez le handle de la vue de gestion dynamique sys.dm_exec_requests pendant que sp_2 s'exécute, la fonction fn_get_sql retourne les informations à propos de sp_2. En outre, la fonction fn_get_sql retourne le texte complet de la procédure stockée au niveau d'imbrication actuel le plus élevé.
Autorisations
L'utilisateur doit disposer de l'autorisation VIEW SERVER STATE sur le serveur.
Exemples
Les administrateurs de base de données peuvent utiliser la fonction fn_get_sql, comme indiqué dans l'exemple suivant pour diagnostiquer les problèmes de traitement. Lorsque l'administrateur identifie un ID de session problématique, il peut récupérer le handle SQL de cette session, appeler fn_get_sql avec le handle, puis utiliser les décalages de début et de fin pour déterminer le texte SQL de l'ID de session problématique.
DECLARE @Handle varbinary(64);
SELECT @Handle = sql_handle
FROM sys.dm_exec_requests
WHERE session_id = 52 and request_id = 0;
SELECT * FROM sys.fn_get_sql(@Handle);
GO
Voir aussi
Référence
DBCC INPUTBUFFER (Transact-SQL)