Compartilhar via


SET CONTEXT_INFO (Transact-SQL)

Associa até 128 bytes de informações binárias à sessão ou conexão atual.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

SET CONTEXT_INFO { binary_str | @binary_var }

Argumentos

  • binary_str
    É uma constante binary, ou uma constante que é implicitamente conversível em binary, a ser associada à sessão ou conexão atual.

  • **@**binary_var
    É uma variável varbinary ou binary que mantém um valor de contexto a ser associado à sessão ou conexão atual.

Comentários

O modo preferido de recuperar as informações de contexto para a sessão atual é usar a função CONTEXT_INFO. As informações de contexto de sessão também são armazenadas nas colunas context_info nas seguintes exibições de sistema:

  • sys.dm_exec_requests

  • sys.dm_exec_sessions

  • sys.sysprocesses

SET CONTEXT_INFO não pode ser especificado em uma função definida pelo usuário. Não é possível fornecer um valor nulo para SET CONTEXT_INFO porque as exibições que mantêm os valores não permitem valores nulos.

SET CONTEXT_INFO não aceita expressões diferentes de constantes ou nomes de variável. Para definir as informações de contexto para o resultado de uma chamada de função, é necessário primeiro incluir o resultado da chamada de função em uma variável binary ou varbinary.

Ao emitir SET CONTEXT_INFO em um procedimento armazenado ou gatilho, diferentemente de outras instruções SET, o novo valor definido para as informações de contexto persiste depois que o procedimento armazenado ou gatilho é concluído.

Exemplos

A. Configurando informações de contexto usando uma constante

O exemplo a seguir demonstra SET CONTEXT_INFO definindo o valor e exibindo os resultados. Observe que consultar sys.dm_exec_sessions requer as permissões SELECT e VIEW SERVER STATE, enquanto que usar a função CONTEXT_INFO não requer.

SET CONTEXT_INFO 0x01010101
GO
SELECT context_info 
FROM sys.dm_exec_sessions
WHERE session_id = @@SPID;
GO

B. Configurando informações de contexto usando uma função

O exemplo a seguir demonstra o uso da saída de uma função para definir o valor de contexto, onde o valor da função deve ser colocado primeiro em uma variável binary.

DECLARE @BinVar varbinary(128)
SET @BinVar = CAST(REPLICATE( 0x20, 128 ) AS varbinary(128) )
SET CONTEXT_INFO @BinVar

SELECT CONTEXT_INFO() AS MyContextInfo;
GO