카테고리:

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