Share via


CONTEXT_INFO(Transact-SQL)

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

이 함수는 현재 세션 또는 일괄 처리에 대해 설정되거나 SET CONTEXT_INFO 문을 사용하여 파생된 context_info 값을 반환합니다.

Transact-SQL 구문 표기 규칙

Syntax

CONTEXT_INFO()  

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

반환 값

context_info 값입니다.

context_info가 설정되지 않은 경우:

  • SQL Server에서 null을 반환합니다.
  • SQL Database에서 고유한 세션별 GUID를 반환합니다.

설명

MARS(Multiple Active Result Sets) 기능을 사용하면 애플리케이션이 같은 시간에 같은 연결에서 여러 일괄 처리 또는 요청을 실행할 수 있습니다. MARS 연결 일괄 처리 중 하나가 SET CONTEXT_INFO를 실행하는 경우 CONTEXT_INFO 함수가 SET 문과 동일한 일괄 처리에서 실행하면 CONTEXT_INFO 함수는 새 컨텍스트 값을 반환합니다. CONTEXT_INFO 함수가 다른 연결 일괄 처리 중 하나 이상을 실행하는 경우 CONTEXT_INFO 함수는 SET 문을 실행한 일괄 처리를 완료한 후에 해당 일괄 처리가 시작되지 않으면 새 값을 반환하지 않습니다.

사용 권한

특별한 권한이 필요하지 않습니다. 다음 시스템 보기는 컨텍스트 정보를 저장하지만 이러한 보기를 직접 쿼리하려면 SELECT 및 VIEW SERVER STATE 권한이 필요합니다.

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

예제

이 간단한 예제에서는 context_info 값을 0x1256698456으로 설정한 다음, CONTEXT_INFO 함수를 사용하여 값을 검색합니다.

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

참고 항목

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