SYSTEM$GET_TAG_ON_CURRENT_TABLE¶

지정된 태그를 기반으로 하는 테이블에 할당된 태그 문자열 값을 반환하거나 지정된 테이블에 태그가 할당되지 않은 경우에는 NULL을 반환합니다.

마스킹 정책 조건 또는 행 액세스 정책 조건에서 이 함수를 사용합니다.

구문¶

SYSTEM$GET_TAG_ON_CURRENT_TABLE( '<tag_name>' )

Copy

'tag_name'

문자열로 표시된 태그의 식별자입니다.

예를 들어 태그가 cost_center 로 명명된 경우 'cost_center' 를 인수로 사용합니다.

현재, 테이블에 설정된 태그 문자열 값을 동적으로 평가하기 위한 마스킹 정책 또는 행 액세스 정책 조건에서만 이 함수를 사용할 수 있습니다.

Snowflake는 SELECT 쿼리, 뷰, 구체화된 뷰 또는 사용자 정의 함수(UDF)에서 이 함수를 사용하는 동안 오류를 반환합니다.
이 함수는 테이블과 유사한 모든 오브젝트(예: 뷰)에 적용됩니다.
이 시스템 함수를 호출할 때 태그가 있어야 합니다. 그렇지 않으면 Snowflake에서 다음 오류 메시지를 반환합니다.
```
Tag '<tag_name>' does not exist or not authorized.
```
Copy

이 함수의 사용 방법에 대한 상황별 예시는 예 3: 테이블 태그 문자열 값을 기반으로 테이블 보호하기 섹션을 참조하십시오.