Compartilhar via


CONTEXT_INFO (Transact-SQL)

Retorna o valor context_info definido para a sessão ou lote atual usando a instrução SET CONTEXT_INFO.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

CONTEXT_INFO()

Valor de retorno

O valor de context_info ou NULL se context_info não for definido.

Comentários

MARS (Vários Conjuntos de Resultados Ativos) permite que os aplicativos sejam executados em vários lotes, ou solicitações, ao mesmo tempo na mesma conexão. Quando um dos lotes em uma conexão MARS executa SET CONTEXT_INFO, o novo valor de contexto é retornado pela função CONTEXT_INFO quando é executado no mesmo lote que a instrução SET. O novo valor não é retornado pela função CONTEXT_INFO executada em um ou mais dos outros lotes da conexão, a menos que sejam iniciados depois do lote que executou a instrução SET completa.

Permissões

Não requer nenhuma permissão especial. As informações de contexto também são armazenadas nas exibições de sistema sys.dm_exec_requests, sys.dm_exec_sessions e sys.sysprocesses, mas a consulta direta às exibições requer as permissões SELECT e VIEW SERVER STATE.

Exemplos

O exemplo simples a seguir define o valor context_info como 0x1256698456 e usa a função CONTEXT_INFO para recuperar o valor.

SET CONTEXT_INFO 0x1256698456
GO
SELECT CONTEXT_INFO()
GO

Consulte também

Referência

SET CONTEXT_INFO (Transact-SQL)