CONTEXT_INFO (Transact-SQL)CONTEXT_INFO (Transact-SQL)

SE APLICA A: síSQL Server síAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Esta función devuelve el valor context_info establecido para la sesión o lote actual, o derivada del uso de la instrucción SET CONTEXT_INFO.This function returns the context_info value either set for the current session or batch, or derived through use of the SET CONTEXT_INFO statement.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

CONTEXT_INFO()  

Valor devueltoReturn value

El valor context_info.The context_info value.

Si context_info no se ha establecido:If context_info was not set:

  • En SQL ServerSQL Server devuelve NULL.In SQL ServerSQL Server returns NULL.
  • En SQL DatabaseSQL Database devuelve un GUID único específico de sesión.In SQL DatabaseSQL Database returns a unique session-specific GUID.

NotasRemarks

La característica de conjuntos de resultados activos múltiples (MARS) permite a las aplicaciones ejecutar varios lotes o solicitudes al mismo tiempo en la misma conexión.The Multiple Active Result Sets (MARS) feature enables applications to run multiple batches, or requests, at the same time, on the same connection. 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 la función CONTEXT_INFO se ejecuta en el mismo lote que la instrucción SET.When one of the MARS connection batches runs SET CONTEXT_INFO, the CONTEXT_INFO function returns the new context value, when the CONTEXT_INFO function runs in the same batch as the SET statement. Si la función CONTEXT_INFO se ejecuta en uno o más de los otros lotes de conexión, CONTEXT_FUNCTION no devuelve el nuevo valor a menos que esos lotes hayan comenzado después de completar el lote que ejecutó la instrucción SET.If the CONTEXT_INFO function runs in one or more of the other connection batches, the CONTEXT_FUNCTION does not return the new value unless those batches started after completion of the batch that ran the SET statement.

PermisosPermissions

No requiere permisos especiales.Requires no special permissions. Las siguientes vistas del sistema almacenan la información de contexto, pero la consulta directa de estas vistas requiere los permisos SELECT y VIEW SERVER STATE:The following system views store the context information, but querying these views directly requires SELECT and VIEW SERVER STATE permissions:

  • sys.dm_exec_requestssys.dm_exec_requests
  • sys.dm_exec_sessionssys.dm_exec_sessions
  • sys.sysprocessessys.sysprocesses

EjemplosExamples

En este ejemplo sencillo se establece el valor de context_info en 0x1256698456 y, después, se usa la función CONTEXT_INFO para recuperarlo.This simple example sets the context_info value to 0x1256698456, and then uses the CONTEXT_INFO function to retrieve the value.

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

Vea tambiénSee also

SET CONTEXT_INFO (Transact-SQL)SET CONTEXT_INFO (Transact-SQL)