카테고리:

컨텍스트 함수 (일반)

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>'
)
Copy

인자

'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');"
    
    Copy

다음 예제에서는 명령을 실행하는 데 사용되는 클라이언트의 이름과 버전을 반환합니다.

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

다음 예제에서는 현재 세션에 대한 계정의 계정 로케이터를 반환합니다.

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

다음 예제에서는 현재 세션에 대한 계정의 리전을 반환합니다.

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