CONTEXT_INFO (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Esta função devolve o valor context_info definido para a sessão ou lote atual, ou derivado através do uso da instrução SET CONTEXT_INFO .

Transact-SQL convenções de sintaxe

Sintaxe

CONTEXT_INFO()  

Valor de retorno

O valor context_info .

Se context_info não estava definido:

• SQL Server devolve NULL.
• A base de dados SQL devolve um GUID único específico para cada sessão.

Observações

A funcionalidade Múltiplos Conjuntos de Resultados Ativos (MARS) permite que as aplicações executem múltiplos lotes, ou pedidos, ao mesmo tempo, na mesma ligação. Quando um dos lotes de ligação MARS executa SET CONTEXT_INFO, a CONTEXT_INFO função devolve o novo valor de contexto, quando a CONTEXT_INFO função executa no mesmo lote que a instrução SET. Se a CONTEXT_INFO função for executada em um ou mais dos outros lotes de ligação, a CONTEXT_INFO função não devolve o novo valor a menos que esses lotes tenham começado após a conclusão do lote que executou a instrução SET.

Permissions

Não requer permissões especiais. As seguintes vistas do sistema armazenam a informação de contexto, mas consultar diretamente estas vistas requer permissões SELECT e VIEW SERVER STATE:

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

Examples

Este exemplo simples define o valor context_info para 0x1256698456, e depois usa a CONTEXT_INFO função para recuperar o valor.

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

Consulte também

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