TAG_REFERENCES_WITH_LINEAGE

지정된 태그와 해당 태그가 연결된 Snowflake 객체 사이의 연관을 각 행에 보여주는 Account Usage 테이블 함수예요. 직접 연관과 태그 상속 모두의 결과를 포함해요.

출처: 공식 문서

본문

각 행이 지정된 태그와 태그가 연결된 Snowflake 객체 사이의 연관을 표시하는 테이블을 반환합니다.

연관된 태그와 Snowflake 객체는 객체에 대한 직접 연관과 태그 상속 모두의 결과입니다.

구문 (Syntax)

TAG_REFERENCES_WITH_LINEAGE( '<name>' )

인자 (Arguments)

'name'

태그의 완전히 한정된 이름입니다. 완전히 한정된 이름은 태그에 대해 부모 태그 데이터베이스와 태그 스키마를 다음 형식으로 지정해야 합니다: <database>.<schema>.<tag_name>.

사용 참고 (Usage notes)

이 함수를 조회하려면 SNOWFLAKE.GOVERNANCE_VIEWER 데이터베이스 역할, ACCOUNTADMIN 역할, 또는 SNOWFLAKE 데이터베이스에 IMPORTED PRIVILEGES가 부여된 역할을 사용하세요. 이 함수는 계정 전체의 태그 연관을 반환하며, 결과는 개별 객체에 대한 접근 권한으로 필터링되지 않습니다.
이 함수는 민감한 데이터 분류에 사용되는 시스템 태그를 지원하지 않습니다.
Account Usage 테이블 함수를 호출할 때는 세션이 Account Usage 스키마를 사용 중이어야 합니다. 자세한 내용은 Account Usage를 참고하세요.
Account Usage 뷰와 비슷하게, 이 테이블 함수를 호출할 때 지연 시간을 고려하세요. 이 테이블 함수의 예상 지연 시간은 TAG_REFERENCES 뷰의 지연 시간과 비슷합니다.

출력 (Output)

함수는 다음 컬럼을 반환합니다:

컬럼	데이터 타입	설명
TAG_DATABASE	TEXT	태그가 설정된 데이터베이스.
TAG_SCHEMA	TEXT	태그가 설정된 스키마.
TAG_ID	NUMBER	태그의 내부/시스템 생성 식별자.
TAG_NAME	TEXT	태그의 이름. 태그의 `key = 'value'` 쌍에서 `key`.
TAG_VALUE	TEXT	태그의 값. 태그의 `key = 'value'` 쌍에서 `'value'`.
LEVEL	TEXT	태그가 설정된 객체 도메인.
OBJECT_DATABASE	TEXT	데이터베이스·스키마 객체에 대한 참조 객체의 데이터베이스 이름. 객체가 데이터베이스나 스키마 객체가 아니면 값은 비어 있음.
OBJECT_SCHEMA	TEXT	참조 객체의 스키마 이름(스키마 객체의 경우). 참조 객체가 스키마 객체가 아니면(예: 웨어하우스) 이 값은 비어 있음.
OBJECT_ID	NUMBER	객체의 내부/시스템 생성 식별자.
OBJECT_NAME	TEXT	태그 연관이 객체에 있으면 참조 객체의 이름.
OBJECT_DELETED	TIMESTAMP_LTZ	연관된 객체 또는 컬럼이 삭제된, 또는 부모 객체가 삭제된 날짜와 시간.
DOMAIN	TEXT	태그 연관이 객체에 있으면 참조 객체의 도메인(예: 테이블, 뷰). 태그 연관이 컬럼에 있으면 도메인은 COLUMN.
COLUMN_ID	NUMBER	컬럼의 내부/시스템 생성 식별자.
COLUMN_NAME	TEXT	참조 컬럼의 이름. 태그 연관이 컬럼이 아니면 해당 없음.
APPLY_METHOD	TEXT	태그가 객체에 어떻게 할당되었는지 지정. 가능한 값은 다음과 같음:
		- `CLASSIFIED`: 민감한 데이터를 포함하는 것으로 분류된 컬럼에 태그가 자동 적용됨. label-classify_auto_map_tags 참고.
		- `INHERITED`: 객체가 Snowflake 보안 가능 객체 계층에서 더 높은 객체로부터 태그를 상속함. Tag inheritance 참고.
		- `MANUAL`: 누군가 CREATE
		- `PROPAGATED`: 태그가 한 객체에서 다른 객체로 자동 전파됨. 사용자 정의 태그의 자동 태그 전파 참고.
		- `NULL`: 레거시 레코드.
		- `NONE`: 레거시 레코드.

예제 (Examples)

cost_center 태그의 태그 연관 목록을 가져옵니다:

select *
  from table(snowflake.account_usage.tag_references_with_lineage('MY_DB.MY_SCHEMA.COST_CENTER'));

참고 태그 이름은 대문자로 작성해야 합니다.

더 알아보기 (Learn more)

TAG_REFERENCES — 태그 참조 뷰
Object tagging — 태깅 소개
Tag inheritance