SYS_CONTEXT

SYS_CONTEXT (SNOWFLAKE$ENVIRONMENT 네임스페이스)

함수가 호출되는 환경(클라이언트, 현재 계정, 현재 리전)에 대한 정보를 반환해요.

참조: SYS_CONTEXT, SYS_CONTEXT (SNOWFLAKE$APPLICATION 네임스페이스), SYS_CONTEXT (SNOWFLAKE$ORGANIZATION 네임스페이스), SYS_CONTEXT (SNOWFLAKE$ORGANIZATION_SESSION 네임스페이스), SYS_CONTEXT (SNOWFLAKE$SESSION 네임스페이스)

출처: Snowflake SQL Reference - SYS_CONTEXT (SNOWFLAKE$ENVIRONMENT)

본문

구문

SYS_CONTEXT( 'SNOWFLAKE$ENVIRONMENT', '<property>' )

인자

'SNOWFLAKE$ENVIRONMENT'

함수가 호출되는 환경에 대한 컨텍스트 정보를 반환하는 속성을 검색하려는 것을 지정해요.

''

검색하려는 속성의 이름이에요. 다음 속성을 지정할 수 있어요:
CLIENT 함수를 호출하는 데 사용된 클라이언트, 드라이버 또는 라이브러리의 이름과 버전. 이 함수가 Snowsight에서 호출되면 함수는 Go Snowflake Driver의 이름과 버전을 반환해요. 이 함수가 Snowflake CLI에서 호출되면 함수는 Snowflake Connector for Python의 이름과 버전을 반환해요. 이 속성의 값은 CURRENT_CLIENT 함수의 반환 값과 같아요.
ACCOUNT 현재 세션의 계정 계정 로케이터(account locator). 이 속성의 값은 CURRENT_ACCOUNT 함수의 반환 값과 같아요.
REGION 현재 세션의 계정 리전 이름. 여러 리전 그룹에 계정이 있는 조직의 경우 속성 값은 region_group.region이에요. 이 속성의 값은 CURRENT_REGION 함수의 반환 값과 같아요.

반환 값

함수는 VARCHAR 값을 반환해요.

2026_06 동작 변경 번들

계정에서 2026_06 동작 변경 번들이 활성화되면 이 네임스페이스의 속성은 계속 VARCHAR를 반환해요.

::BOOLEAN 또는 ::NUMBER 같은 기존 캐스트는 변경 없이 계속 동작해요.

네임스페이스별 모든 속성과 함수의 반환 타입에 대해서는 SYS_CONTEXT return types를 참고해요.

사용상 주의사항

  • 셸에서 큰따옴표로 묶인 문자열에 함수 호출을 지정하는 경우 $ 문자를 백슬래시(\)로 이스케이프해 $ENVIRONMENT가 셸 변수로 해석되지 않도록 해요. 예를 들어 Snowflake CLI를 사용하고 SQL 문을 큰따옴표로 묶인 명령줄 인자로 지정하는 경우: snow sql --query "SELECT SYS_CONTEXT('SNOWFLAKE \$ENVIRONMENT', 'CLIENT');"

예시

다음 예시는 명령을 실행하는 데 사용된 클라이언트의 이름과 버전을 반환해요:

SELECT SYS_CONTEXT('SNOWFLAKE$ENVIRONMENT', 'CLIENT');

다음 예시는 현재 세션의 계정 계정 로케이터를 반환해요:

SELECT SYS_CONTEXT('SNOWFLAKE$ENVIRONMENT', 'ACCOUNT');

다음 예시는 현재 세션의 계정 리전을 반환해요:

SELECT SYS_CONTEXT('SNOWFLAKE$ENVIRONMENT', 'REGION');

더 알아보기