TAG_REFERENCES_ALL_COLUMNS

TAG_REFERENCES_ALL_COLUMNS

각 행이 특정 컬럼에 할당된 태그 이름과 태그 값을 보여주는 테이블을 반환해요. 이 함수는 주어진 테이블 또는 뷰의 모든 컬럼에 설정된 모든 태그를 반환해요. 태그가 컬럼에 직접 할당되었는지, 태그 상속(tag inheritance)을 통한 것인지는 관계없어요.

출처: Snowflake SQL Reference - TAG_REFERENCES_ALL_COLUMNS

본문

구문

TAG_REFERENCES_ALL_COLUMNS( object_name , object_domain )

인자

object_name 태그 연결이 객체에 있는 경우, 참조되는 객체의 이름이에요. 이 인자는 테이블과 뷰의 이름을 지원해요.

object_domain 참조 객체의 도메인이에요. Snowflake는 이 함수에 대해 한 가지 도메인인 TABLE만 지원해요. 객체 이름이 뷰(즉, view, materialized view)여도 컬럼을 포함하는 모든 객체에는 도메인 TABLE을 사용해야 해요.

사용 시 유의사항

  • 지정한 객체에 대한 접근 권한이 있는 역할에 대해서만 결과가 반환돼요. 민감 데이터 분류와 연결된 시스템 태그에 대한 참조를 보려면 공유된 SNOWFLAKE 데이터베이스에 IMPORTED PRIVILEGES가 있는 역할을 사용해요.
  • Information Schema 테이블 함수를 호출할 때 세션에 INFORMATION_SCHEMA 스키마가 사용 중이거나 함수가 정규화된(fully-qualified) 객체 이름을 사용해야 해요. 자세한 내용은 Snowflake Information Schema를 참고하세요.

출력

이 함수는 다음 컬럼을 반환해요:

Column Data Type Description
TAG_DATABASE TEXT 태그가 설정된 데이터베이스
TAG_SCHEMA TEXT 태그가 설정된 스키마
TAG_NAME TEXT 태그의 이름. 태그의 key = value 쌍에서 key에 해당해요.
TAG_VALUE TEXT 태그의 값. 태그의 key = value 쌍에서 value에 해당해요.
APPLY_METHOD TEXT 태그가 객체에 할당된 방식을 지정해요. 가능한 값은 다음과 같아요:
- CLASSIFIED: 민감 데이터를 포함하는 것으로 분류된 컬럼에 태그가 자동으로 적용됨. label-classify_auto_map_tags 참고.
- INHERITED: 객체가 Snowflake 보안 객체 계층에서 더 상위에 있는 객체로부터 태그를 상속받음. Tag inheritance 참고.
- MANUAL: 누군가 CREATE object 또는 ALTER object 명령으로 객체에 태그를 수동으로 설정함. label-object_tagging_set 참고.
- PROPAGATED: 한 객체에서 다른 객체로 태그가 자동으로 전파됨. Automatic tag propagation with user-defined tags 참고.
- NULL: 레거시 레코드.
- NONE: 레거시 레코드.
LEVEL TEXT 태그가 설정된 객체 도메인
OBJECT_DATABASE TEXT 테이블 또는 뷰를 포함하는 데이터베이스 이름
OBJECT_SCHEMA TEXT 테이블 또는 뷰를 포함하는 스키마 이름
OBJECT_NAME TEXT 테이블 또는 뷰의 이름
DOMAIN TEXT 이 함수는 테이블 또는 뷰의 모든 컬럼에 설정된 모든 태그를 반환하므로 이 값은 COLUMN이어야 해요.
COLUMN_NAME TEXT 태그가 설정된 컬럼의 이름

예시

my_table 테이블의 모든 컬럼에 할당된 태그 목록을 검색해요:

select *
  from table(my_db.information_schema.tag_references_all_columns(my_table, table));

더 알아보기 (Learn more)