카테고리:

컨텍스트 함수 (일반)

SYS_CONTEXT

함수가 호출되는 컨텍스트에 대한 정보를 반환합니다.

참고 항목:

SYS_CONTEXT(SNOWFLAKE$APPLICATION 네임스페이스) , SYS_CONTEXT(SNOWFLAKE$ENVIRONMENT 네임스페이스) , SYS_CONTEXT(SNOWFLAKE$ORGANIZATION 네임스페이스) , SYS_CONTEXT(SNOWFLAKE$ORGANIZATION_SESSION 네임스페이스) , SYS_CONTEXT(SNOWFLAKE$SESSION 네임스페이스)

구문

속성 검색을 위한 구문:

SYS_CONTEXT(
  '<namespace>' ,
  '<property>'
)
Copy

함수 호출을 위한 구문:

SYS_CONTEXT(
  '<namespace>' ,
  '<function>' , '<argument>' [ , ... ]
)
Copy

인자

'namespace'

검색하려는 속성 또는 호출하려는 함수의 네임스페이스입니다. 다음 네임스페이스 중 하나를 지정할 수 있습니다.

네임스페이스

설명

SNOWFLAKE$APPLICATION

함수가 호출되는 애플리케이션과 관련된 컨텍스트를 제공하는 속성 및 함수입니다.

SNOWFLAKE$ENVIRONMENT

함수가 호출되는 환경에 대한 컨텍스트를 제공하는 속성입니다. 이러한 속성에는 다음에 대한 정보가 포함됩니다.

  • 함수를 호출하는 데 사용되는 클라이언트, 드라이버 또는 라이브러리입니다.

  • 함수가 호출되는 세션과 연결된 계정입니다.

  • 해당 계정의 리전입니다.

SNOWFLAKE$ORGANIZATION

현재 조직에 대한 컨텍스트를 제공하는 함수입니다.

SNOWFLAKE$ORGANIZATION_SESSION

현재 계정이 조직에 있을 때 함수가 호출되는 세션과 관련된 컨텍스트를 제공하는 속성입니다.

SNOWFLAKE$SESSION

함수가 호출되는 세션과 관련된 컨텍스트를 제공하는 속성 및 함수입니다.
'property'

검색할 속성의 이름입니다. 지정할 수 있는 속성은 네임스페이스에 따라 다릅니다. 지정할 수 있는 속성 목록은 네임스페이스에 대한 설명서 섹션을 참조하세요.

'function'

호출하려는 함수의 이름입니다. 호출할 수 있는 함수는 네임스페이스에 따라 다릅니다. 호출할 수 있는 함수 목록은 네임스페이스에 대한 설명서 섹션을 참조하세요.

'argument' [ , ... ]

호출하려는 함수에 전달할 인자입니다.

반환

이 함수는 VARCHAR 값 또는 NULL을 반환합니다.

  • 반환 값은 검색 중인 속성 또는 호출 중인 함수에 따라 다릅니다.

    해당 네임스페이스에 있는 함수의 속성 및 반환 값에 대한 정보는 각 네임스페이스에 대한 설명서 섹션을 참조하세요.

  • 다음의 경우 함수는 NULL을 반환합니다.

    • 함수 호출의 컨텍스트 내에서는 네임스페이스에 액세스할 수 없습니다. 예를 들어, 애플리케이션 코드 외부에서 함수를 호출하는 경우 SNOWFLAKE$APPLICATION 네임스페이스의 속성에 액세스하려고 시도하면 NULL이 반환됩니다.

    • 속성의 값 또는 함수 호출의 반환 값은 NULL이거나 존재하지 않습니다.

일부 속성 및 함수는 부울 값을 TRUE 또는 FALSE 문자열로 반환합니다. 이 반환 값을 BOOLEAN 값 TRUE 또는 FALSE와 비교하려면 반환 값을 :ref:`캐스트<label-data_type_explicit_casting>`하여 BOOLEAN로 반환합니다. 예:

SELECT SYS_CONTEXT('SNOWFLAKE$SESSION', 'IS_ROLE_ACTIVATED', 'MY_CUSTOM_ROLE')::BOOLEAN = TRUE;
Copy
+-----------------------------------------------------------------------------------------+
| SYS_CONTEXT('SNOWFLAKE$SESSION', 'IS_ROLE_ACTIVATED', 'MY_CUSTOM_ROLE')::BOOLEAN = TRUE |
|-----------------------------------------------------------------------------------------|
| True                                                                                    |
+-----------------------------------------------------------------------------------------+

액세스 제어 요구 사항

해당 네임스페이스의 속성 및 함수에 대한 액세스 제어 요구 사항에 대한 정보는 각 네임스페이스에 대한 설명서 섹션을 참조하세요.

사용법 노트

해당 네임스페이스의 속성 및 함수에 대한 사용법 노트는 각 네임스페이스에 대한 설명서 섹션을 참조하세요.

예

해당 네임스페이스에서 속성을 검색하고 함수를 호출하는 예는 각 네임스페이스에 대한 설명서 섹션을 참조하세요.

언어: 한국어