CONTEXT_INFO (Transact-SQL)

Restituisce il valore di context_info impostato per la sessione o il batch corrente tramite l'istruzione SET CONTEXT_INFO.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

CONTEXT_INFO()

Valore restituito

Valore di context_info o NULL se l'opzione context_info non è stata impostata.

Osservazioni

Grazie alla funzionalità MARS (Multiple Active Result Set) le applicazioni sono in grado di eseguire più batch o richieste contemporaneamente utilizzando la stessa connessione. Se uno dei batch in una connessione MARS esegue l'istruzione SET CONTEXT_INFO, il nuovo valore del contesto viene restituito dalla funzione CONTEXT_INFO quando viene eseguita nello stesso batch dell'istruzione SET. Il nuovo valore non viene restituito dalla funzione CONTEXT_INFO eseguita in uno o più degli altri batch nella connessione a meno che tali batch non siano stati avviati dopo il completamento del batch che ha eseguito l'istruzione SET.

Autorizzazioni

Non sono richieste autorizzazioni particolari. Le informazioni sul contesto sono archiviate anche nelle viste di sistema sys.dm_exec_requests, sys.dm_exec_sessions e sys.sysprocesses, ma per l'esecuzione di query direttamente su tali viste è necessario disporre delle autorizzazioni SELECT e VIEW SERVER STATE.

Esempi

Nell'esempio seguente viene impostato il valore di context_info su 0x1256698456 e quindi viene utilizzata la funzione CONTEXT_INFO per recuperare il valore.

SET CONTEXT_INFO 0x1256698456
GO
SELECT CONTEXT_INFO()
GO