CONTEXT_INFO (Transact-SQL)

Renvoie la valeur context_info définie pour la session ou le lot en cours à l'aide de l'instruction SET CONTEXT_INFO.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

CONTEXT_INFO()

Valeur de retour

La valeur de context_info, ou la valeur NULL si context_info n'était pas défini.

Notes

MARS (Multiple active result sets) permet aux applications d'exécuter simultanément plusieurs lots ou requêtes sur la même connexion. Lorsqu'un lot d'une connexion MARS exécute la procédure SET CONTEXT_INFO, la fonction CONTEXT_INFO renvoie la nouvelle valeur de contexte lorsqu'elle est exécutée dans le même lot que l'instruction SET. La fonction CONTEXT_INFO ne renvoie pas la nouvelle valeur lorsqu'elle est exécutée dans un ou plusieurs autres lots sur la connexion, sauf s'ils ont démarré une fois que le lot ayant exécuté l'instruction SET était terminé.

Autorisations

Ne nécessite aucune autorisation particulière. Les informations de contexte sont également stockées dans les vues système sys.dm_exec_requests, sys.dm_exec_sessions et sys.sysprocesses. En revanche, vous devez bénéficier des autorisations SELECT et VIEW SERVER STATE pour interroger directement les vues.

Exemples

L'exemple suivant attribue à context_info la valeur 0x1256698456, puis utilise la fonction CONTEXT_INFO pour extraire la valeur.

SET CONTEXT_INFO 0x1256698456
GO
SELECT CONTEXT_INFO()
GO

Voir aussi

Référence

SET CONTEXT_INFO (Transact-SQL)

Autres ressources

Utilisation des informations de contexte de session

Aide et Informations

Assistance sur SQL Server 2005