스키마:

ORGANIZATION_USAGE

TAG_REFERENCES 뷰

중요

이 뷰는 조직 계정에서만 사용할 수 있습니다. 자세한 내용은 조직 계정의 프리미엄 뷰 섹션을 참조하십시오.

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

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

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

열

조직 수준 열

열 이름

데이터 타입

설명

ORGANIZATION_NAME

VARCHAR

조직의 이름입니다.

ACCOUNT_LOCATOR

VARCHAR

시스템에서 생성된 계정 식별자입니다.

ACCOUNT_NAME

VARCHAR

계정에 대한 사용자 정의 식별자입니다.

추가 열

열 이름

데이터 타입

설명

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

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

APPLY_METHOD

TEXT

태그가 오브젝트에 할당된 방법을 지정합니다. 사용 가능한 값은 다음과 같습니다.

  • CLASSIFIED: 민감한 데이터가 포함된 것으로 분류된 열에 태그가 자동으로 적용되었습니다. 태그 매핑 정보 섹션을 참조하십시오.

  • INHERITED: 이 오브젝트는 Snowflake 보안 가능한 오브젝트 계층 구조에서 상위의 오브젝트로부터 태그를 상속받았습니다. 태그 상속 섹션을 참조하십시오.

  • MANUAL: 누군가 CREATE <object> 또는 ALTER <object> 명령을 사용하여 오브젝트에 태그를 수동으로 설정했습니다. 태그 설정하기 섹션을 참조하십시오.

  • PROPAGATED: 태그는 한 오브젝트에서 다른 오브젝트로 자동으로 전파되었습니다. 사용자 정의 태그를 통한 자동 태그 전파 섹션을 참조하십시오.

  • NULL: 레거시 레코드입니다.

  • NONE: 레거시 레코드입니다.

사용법 노트

  • 뷰의 지연 시간은 최대 24시간입니다.

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

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

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

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

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

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

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

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

예

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

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

Snowflake 계정에 태그 연결이 있는 활성 오브젝트를 반환합니다. 지정된 WHERE 절을 추가하면 삭제된 오브젝트가 필터링됩니다.

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