SYSTEM$GET_TAG_ON_CURRENT_TABLE

SYSTEM$GET_TAG_ON_CURRENT_TABLE

지정된 태그를 기반으로 테이블에 할당된 태그 문자열 값을 반환하거나, 지정된 테이블에 태그가 할당되지 않았으면 NULL을 반환해요.

마스킹 정책 조건이나 행 액세스 정책 조건에서 이 함수를 사용해요.

출처: Snowflake SYSTEM$GET_TAG_ON_CURRENT_TABLE 함수 문서

본문

구문 (Syntax)

SYSTEM$GET_TAG_ON_CURRENT_TABLE( '<tag_name>' )

인자 (Arguments)

  • 'tag_name' — 문자열로 된 태그의 식별자예요. 예를 들어 태그 이름이 cost_center이면 'cost_center'를 인자로 사용해요.

사용 참고 (Usage Notes)

  • 현재 이 함수는 테이블에 설정된 태그 문자열 값을 동적으로 평가하기 위해 마스킹 정책이나 행 액세스 정책 조건에서만 사용할 수 있어요. SELECT 쿼리, 뷰, 구체화된 뷰 또는 사용자 정의 함수(UDF)에서 이 함수를 사용하면 Snowflake가 오류를 반환해요.
  • 이 함수는 모든 테이블류 객체(예: 뷰)에 적용된다는 점에 유의하세요.
  • 태그가 다중 값 태그이고 값이 두 개 이상 할당된 경우 이 함수는 오류를 반환해요. 정책 조건에서는 다중 값 태그를 참조하지 마세요.
  • 이 시스템 함수를 호출할 때 태그가 존재해야 해요. 그렇지 않으면 Snowflake가 다음 오류 메시지를 반환해요: 
    Tag '<tag_name>' does not exist or not authorized.

예제 (Examples)

이 함수를 사용하는 방법에 대한 맥락적 예제는 예제 3: 테이블 태그 문자열 값을 기반으로 테이블 보호를 참고하세요.

더 알아보기