SYS_CONTEXT

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

현재 조직에 대한 정보를 반환해요.

조직의 모든 계정에서 이 함수를 호출할 수 있어요. 다른 컨텍스트에서는 함수가 NULL을 반환해요.

참고 항목:

  • SYS_CONTEXT, SYS_CONTEXT(SNOWFLAKE$APPLICATION 네임스페이스), SYS_CONTEXT(SNOWFLAKE$ENVIRONMENT 네임스페이스), SYS_CONTEXT(SNOWFLAKE$ORGANIZATION_SESSION 네임스페이스), SYS_CONTEXT(SNOWFLAKE$SESSION 네임스페이스), IS_GROUP_ACTIVATED(SYS_CONTEXT 함수), IS_GROUP_IMPORTED(SYS_CONTEXT 함수), IS_USER_IMPORTED(SYS_CONTEXT 함수)

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

본문

구문

함수를 호출하기 위한 구문:

SYS_CONTEXT(
  'SNOWFLAKE$ORGANIZATION' ,
  '<function>' , '<argument>' [ , ... ]
)

인자

'SNOWFLAKE$ORGANIZATION'

  • 현재 조직에 대한 컨텍스트 정보를 반환하는 속성을 검색하거나 함수를 호출하려고 함을 지정해요.

'function'

  • 호출할 함수의 이름이에요. 다음 함수를 호출할 수 있어요. IS_GROUP_ACTIVATED(SYS_CONTEXT 함수), IS_GROUP_IMPORTED(SYS_CONTEXT 함수), IS_USER_IMPORTED(SYS_CONTEXT 함수)

'argument' [ , ... ]

  • 호출할 함수에 전달할 인자들이에요.

반환

이 함수는 VARCHAR 값이나 NULL을 반환해요.

  • 반환 값은 호출하는 함수에 따라 달라져요.
  • 지원되는 컨텍스트 밖에서 SNOWFLAKE$ORGANIZATION 네임스페이스로 SYS_CONTEXT를 호출하면 함수는 NULL을 반환해요.

2026_06 동작 변경 번들

계정에서 2026_06 동작 변경 번들이 활성화되면 IS_USER_IMPORTED, IS_GROUP_IMPORTED, IS_GROUP_ACTIVATED 함수가 BOOLEAN을 반환해요.

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

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

사용법 참고 사항

  • 셸의 큰따옴표 문자열에서 함수 호출을 지정한다면 $ 문자를 백슬래시(\)로 이스케이프해 $ORGANIZATION이 셸 변수로 해석되지 않게 해요. 예를 들어 Snowflake CLI를 사용하고 큰따옴표로 SQL 문을 명령줄 인자로 지정한다면 다음과 같이 해요.
snow sql --query "SELECT SYS_CONTEXT('SNOWFLAKE\$ORGANIZATION', 'IS_USER_IMPORTED', 'my_user_name');"

예제

다음 주제를 참고해요.

  • IS_GROUP_ACTIVATED(SYS_CONTEXT 함수)
  • IS_GROUP_IMPORTED(SYS_CONTEXT 함수)
  • IS_USER_IMPORTED(SYS_CONTEXT 함수)

더 알아보기