• Artículo

CONTEXT_INFO (Transact-SQL)

Devuelve el valor context_info establecido para la sesión o lote actual mediante la instrucción SET CONTEXT_INFO.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

CONTEXT_INFO()

Valor devuelto

Valor de context_info o NULL si no se ha establecido context_info.

Notas

Los conjuntos de resultados activos múltiples (MARS) permiten a las aplicaciones ejecutar varios lotes o solicitudes al mismo tiempo en la misma conexión. Cuando uno de los lotes de una conexión MARS ejecuta SET CONTEXT_INFO, la función CONTEXT_INFO devuelve el nuevo valor de contexto cuando se ejecuta en el mismo lote que la instrucción SET. La función CONTEXT_INFO ejecutada en uno o varios de los demás lotes de la conexión no devuelve el nuevo valor a menos que se hayan iniciado después de haber finalizado el lote que ejecutó la instrucción SET.

Permisos

No requiere permisos especiales. La información de contexto también se almacena en las vistas del sistema sys.dm_exec_requests, sys.dm_exec_sessions y sys.sysprocesses, pero para consultar estas vistas directamente se requieren los permisos SELECT y VIEW SERVER STATE.

Ejemplos

En el ejemplo siguiente se establece el valor de context_info en 0x1256698456 y, después, se utiliza la función CONTEXT_INFO para recuperarlo.

SET CONTEXT_INFO 0x1256698456
GO
SELECT CONTEXT_INFO()
GO