카테고리:: Account Usage 테이블 함수 , 테이블 함수

TAG_REFERENCES_WITH_LINEAGE¶

각 행에 지정된 태그와 이 태그가 연결되어 있는 Snowflake 오브젝트 간의 연결이 표시되는 테이블을 반환합니다.

연결된 태그와 Snowflake 오브젝트는 오브젝트에 직접 연결하고 태그 계보를 통해 연결한 결과입니다.

구문¶

TAG_REFERENCES_WITH_LINEAGE( '<name>' )

Copy

인자¶

'name'

태그의 정규화된 이름입니다.

정규화된 이름은 상위 태그 데이터베이스와 태그에 대한 태그 스키마를 다음 형식으로 지정해야 합니다.

<태그_데이터베이스>.<태그_스키마>.<태그_이름>

사용법 노트¶

지정된 오브젝트에 액세스할 권한이 있는 역할에 대해서만 결과가 반환됩니다.

시스템 태그 에 대한 참조를 확인하려면 공유 SNOWFLAKE 데이터베이스에서 IMPORTED PRIVILEGES 를 가진 역할을 사용하십시오.
Account Usage 테이블 함수를 호출할 때 세션에는 사용 중인 Account Usage 스키마가 있어야 합니다. 자세한 내용은 Account Usage 섹션을 참조하십시오.
Account Usage 뷰와 유사하게, 이 테이블 함수를 호출하는 경우에도 지연 시간을 고려해야 합니다. 이 테이블 함수의 예상 지연 시간은 TAG_REFERENCES 뷰의 지연 시간과 유사합니다.

출력¶

이 함수는 다음 열을 반환합니다.

열	데이터 타입	설명
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	참조된 열의 이름입니다. 태그 연결이 열이 아닌 경우에는 적용되지 않습니다.

예¶

cost_center 태그에 대한 태그 연결 목록을 검색합니다.

select *
  from table(snowflake.account_usage.tag_references_with_lineage('my_db.my_schema.cost_center'));

Copy