카테고리:

컨텍스트 함수 (일반)

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

함수가 호출된 세션과 현재 조직 사용자에 대한 정보를 반환합니다.

다음 컨텍스트에서 이 함수를 호출할 수 있습니다.

  • 현재 세션에서 이 함수를 직접 호출할 수 있습니다.

  • 이 함수를 호출하는 호출자 권한 실행 파일(예: 호출자 권한 저장 프로시저)을 실행할 수 있습니다.

  • 다음과 같은 경우 이 함수를 호출하는 소유자 권한 실행 파일(예: 소유자 권한 저장 프로시저)을 실행할 수 있습니다.

    • 계정에 대한 READ SESSION 권한이 소유자 역할에 부여되었습니다.

    • 소유자 역할이 포함된 계정은 세션의 현재 계정과 동일한 조직입니다.

다른 모든 컨텍스트에서 함수는 NULL을 반환합니다.

참고 항목:

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

구문

속성 검색을 위한 구문:

SYS_CONTEXT(
  'SNOWFLAKE$ORGANIZATION_SESSION' ,
  '<property>'
)
Copy

인자

'SNOWFLAKE$ORGANIZATION_SESSION'

현재 계정이 조직에 있는 경우 속성을 검색하거나 함수를 호출하여 함수가 호출되는 세션에 대한 정보를 반환하도록 지정합니다.

'property'

검색할 속성의 이름입니다. 다음 속성을 지정할 수 있습니다.

속성

설명

PRINCIPAL_NAME

세션을 시작한 주체의 이름(조직 사용자)입니다.

현재 사용자가 조직 사용자가 아닌 경우 이 속성의 값은 NULL입니다.

반환

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

  • 반환 값은 :ref:`검색 중인 속성<label-sys_context_snowflake_organization_session_property>`에 따라 다릅니다.

  • 지원되는 컨텍스트 외부에서 SNOWFLAKE$ORGANIZATION_SESSION 네임스페이스를 사용하여 SYS_CONTEXT를 호출하는 경우 함수는 NULL을 반환합니다.

사용법 노트

  • 셸에서 큰따옴표로 묶인 문자열에 함수 호출을 지정하는 경우 $ 문자를 백슬래시(\)로 이스케이프하여 ``$ORGANIZATION_SESSION``이 셸 변수로 해석되지 않습니다.

    예를 들어, |sf-cli|를 사용하고 SQL 문을 큰따옴표로 묶어 명령줄 인자로 지정하는 경우:

    snow sql --query "SELECT SYS_CONTEXT('SNOWFLAKE\$ORGANIZATION_SESSION', 'PRINCIPAL_NAME');"
    Copy

예

다음 예에서는 현재 세션에 대한 조직 사용자의 이름을 반환합니다.

SELECT SYS_CONTEXT('SNOWFLAKE$ORGANIZATION_SESSION', 'PRINCIPAL_NAME');
Copy
+-----------------------------------------------------------------+
| SYS_CONTEXT('SNOWFLAKE$ORGANIZATION_SESSION', 'PRINCIPAL_NAME') |
|-----------------------------------------------------------------|
| my_organization_user_name                                       |
+-----------------------------------------------------------------+
언어: 한국어