- 카테고리:
컨텍스트 함수 (일반)
SYS_CONTEXT(SNOWFLAKE$ENVIRONMENT 네임스페이스)¶
함수가 호출되는 환경(클라이언트, 현재 계정, 현재 리전)에 대한 정보를 반환합니다.
- 참고 항목:
SYS_CONTEXT , SYS_CONTEXT(SNOWFLAKE$APPLICATION 네임스페이스) , SYS_CONTEXT(SNOWFLAKE$ORGANIZATION 네임스페이스) , SYS_CONTEXT(SNOWFLAKE$ORGANIZATION_SESSION 네임스페이스) , SYS_CONTEXT(SNOWFLAKE$SESSION 네임스페이스)
구문¶
SYS_CONTEXT(
'SNOWFLAKE$ENVIRONMENT' ,
'<property>'
)
인자¶
'SNOWFLAKE$ENVIRONMENT'함수가 호출되는 환경에 대한 컨텍스트 정보를 반환하기 위해 속성을 검색하도록 지정합니다.
'property'검색할 속성의 이름입니다. 다음 속성을 지정할 수 있습니다.
속성
설명
CLIENT함수를 호출하는 데 사용되는 클라이언트, 드라이버 또는 라이브러리의 이름과 버전입니다.
이 함수가 |sf-web-interface|에서 호출되는 경우 함수는 Go Snowflake 드라이버의 이름과 버전을 반환합니다.
이 함수가 |sf-cli|에서 호출되는 경우 함수는 Python 용 Snowflake Connector의 이름과 버전을 반환합니다.
이 속성의 값은 CURRENT_CLIENT 함수의 반환 값과 동일합니다.
ACCOUNT현재 세션에 대한 계정의 :ref:`계정 로케이터<label-account_locator>`입니다.
이 속성의 값은 CURRENT_ACCOUNT 함수의 반환 값과 동일합니다.
REGION현재 세션에 대한 계정의 리전 이름입니다.
여러 :ref:`리전 그룹<label-region_groups>`에 계정이 있는 조직의 경우 속성 값은 :samp:`{region_group}.{region}`입니다.
이 속성의 값은 CURRENT_REGION 함수의 반환 값과 동일합니다.
반환¶
이 함수는 VARCHAR 값을 반환합니다.
사용법 노트¶
셸에서 큰따옴표로 묶인 문자열에 함수 호출을 지정하는 경우
$문자를 백슬래시(\)로 이스케이프하여 ``$ENVIRONMENT``이 셸 변수로 해석되지 않습니다.예를 들어, |sf-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');