CONTEXT_INFO (Transact-SQL)

  • Articolo

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure

Questa funzione restituisce il valore di context_info impostato per la sessione o il batch corrente oppure derivato tramite l'uso dell'istruzione SET CONTEXT_INFO.

Convenzioni di sintassi Transact-SQL

Sintassi

CONTEXT_INFO()

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Valore restituito

Valore di context_info.

Se context_info non è stato impostato:

  • SQL Server restituisce NULL.
  • Il database SQL restituisce un GUID univoco specifico della sessione.

Osservazioni:

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

Autorizzazioni

Non sono richieste autorizzazioni particolari. Le viste di sistema seguenti archiviano le informazioni del contesto, ma per l'esecuzione di query dirette su tali viste sono necessarie le autorizzazioni SELECT e VIEW SERVER STATE:

  • sys.dm_exec_requests
  • sys.dm_exec_sessions
  • sys.sysprocesses

Esempi

Questo semplice esempio imposta il valore di context_info su 0x1256698456 e quindi usa la funzione CONTEXT_INFO per recuperare il valore.

SET CONTEXT_INFO 0x1256698456;  
GO  
SELECT CONTEXT_INFO();  
GO

Vedi anche

SET CONTEXT_INFO (Transact-SQL)SESSION_CONTEXT (Transact-SQL)
sp_set_session_context (Transact-SQL)