스키마:

ACCOUNT_USAGE

TAG_REFERENCES 뷰

이 Account Usage 뷰는 오브젝트와 태그 간의 연결을 식별하는 데 사용할 수 있습니다.

이 뷰는 오브젝트와 태그 간의 직접적인 관계만 기록합니다. 태그 계보는 이 뷰에 포함되지 않습니다.

뷰는 정보 스키마 테이블 함수 TAG_REFERENCES 를 보완합니다.

열

열 이름

데이터 타입

설명

TAG_DATABASE

TEXT

태그가 설정된 데이터베이스입니다.

TAG_SCHEMA

TEXT

태그가 설정된 스키마입니다.

TAG_ID

NUMBER

태그의 내부/시스템 생성 식별자입니다. 시스템 태그 의 경우 이 값은 NULL입니다.

TAG_NAME

TEXT

태그의 이름입니다. 이는 태그의 key = 'value' 쌍에 있는 key 입니다.

TAG_VALUE

TEXT

태그의 값입니다. 이는 태그의 key = 'value' 쌍에 있는 'value' 입니다.

OBJECT_DATABASE

TEXT

데이터베이스 및 스키마 오브젝트에 대해 참조된 오브젝트의 데이터베이스 이름입니다. 오브젝트가 데이터베이스 또는 스키마 오브젝트가 아닌 경우, 값은 비어 있습니다.

OBJECT_SCHEMA

TEXT

참조된 오브젝트의 스키마 이름(스키마 오브젝트의 경우)입니다. 참조된 오브젝트가 스키마 오브젝트(예: 웨어하우스)가 아닌 경우, 이 값은 비어 있습니다.

OBJECT_ID

NUMBER

참조된 오브젝트의 내부 식별자입니다.

OBJECT_NAME

TEXT

태그 연결이 오브젝트에 있는 경우, 참조된 오브젝트의 이름입니다. 태그 연결이 열에 있는 경우, Snowflake는 상위 테이블 이름을 반환합니다.

OBJECT_DELETED

TIMESTAMP_LTZ

연결된 오브젝트가 삭제되었거나 상위 오브젝트가 삭제된 경우의 날짜 및 시간입니다. . 자세한 내용은 (이 항목의) 사용법 노트 섹션을 참조하십시오.

DOMAIN

TEXT

태그 연결이 오브젝트에 있는 경우, 참조 오브젝트(예: 테이블, 뷰)의 도메인입니다. 열의 경우, 태그 연결이 열에 있으면 도메인은 COLUMN입니다. 자세한 내용은 지원되는 도메인 을 참조하십시오.

COLUMN_ID

NUMBER

참조 열의 로컬 식별자입니다. 태그 연결이 열이 아닌 경우에는 적용되지 않습니다.

COLUMN_NAME

TEXT

참조된 열의 이름입니다. 태그 연결이 열이 아닌 경우에는 적용되지 않습니다.

사용법 노트

  • 뷰의 지연 시간은 최대 120분(2시간)입니다.

  • 뷰에는 세션의 현재 역할에 액세스 권한이 부여된 오브젝트만 표시됩니다.

  • TAG_DATABASE_ID 열은 이 뷰에 포함되지 않습니다. 쿼리 결과에서 이 값을 얻으려면 TAGS 뷰 로 JOIN 작업을 수행하십시오.

  • 이 열에는 삭제된 열에 대해 하나 이상의 태그가 설정된 삭제된 열의 타임스탬프가 포함되지 않습니다.

    참고로, 다음 이벤트 중 하나가 발생하면 삭제된 열이 생깁니다.

    • 이 열이 테이블에서 삭제되거나(즉, ALTER TABLE ... DROP COLUMN col_name)

    • 열을 포함하는 상위 테이블이 삭제되거나(즉, DROP TABLE name)

    • 열을 포함하는 상위 스키마가 삭제되거나(즉, DROP SCHEMA name)

    • 열을 포함하는 상위 데이터베이스가 삭제됩니다(즉, DROP DATABASE name).

예

Snowflake 계정에 대한 태그 참조를 반환합니다.

select tag_name, tag_value, domain, object_id
from snowflake.account_usage.tag_references
order by tag_name, domain, object_id;
Copy

Snowflake 계정에 태그 연결이 있는 활성 오브젝트를 반환합니다. 지정된 WHERE 절을 추가하는 경우, 삭제되었지만 아직 시스템에서 제거되지 않은 오브젝트가 필터링됩니다.

select tag_name, tag_value, domain, object_id
from snowflake.account_usage.tag_references
where object_deleted is null
order by tag_name, domain, object_id;
Copy
언어: 한국어