CONTEXT_INFO (Transact-SQL)

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric의 SQL 데이터베이스

이 함수는 현재 세션 또는 배치에 설정된 context_info 값을 반환하거나, 문 SET CONTEXT_INFO 장을 사용하여 파생된 값입니다.

Transact-SQL 구문 표기 규칙

구문

CONTEXT_INFO()  

반환 값

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)