카테고리:

Information Schema , 테이블 함수

TAG_REFERENCES

각 행에 태그와 값 간의 연결이 표시되는 테이블을 반환합니다.

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

구문

TAG_REFERENCES( '<object_name>' , '<object_domain>' )
Copy

인자

'object_name'

태그 연결이 오브젝트에 있는 경우, 참조된 오브젝트의 이름입니다.

'object_domain'

태그 연결이 오브젝트에 있는 경우 참조 오브젝트(예: 테이블 또는 뷰)의 도메인입니다. 열의 경우, 태그 연결이 열에 있으면 도메인은 COLUMN 입니다.

다음 값 중 하나를 사용합니다.

  • 'ACCOUNT'

  • 'ALERT'

  • 'COLUMN'

  • 'DATABASE'

  • 'DATABASE ROLE'

  • 'FUNCTION'

  • 'INTEGRATION'

  • 'NETWORK POLICY'

  • 'PROCEDURE'

  • 'ROLE'

  • 'SCHEMA'

  • 'SHARE'

  • 'STAGE'

  • 'STREAM'

  • 'TABLE': 뷰, 구체화된 뷰, 외부 테이블 등 모든 테이블 형식 오브젝트에 이 값을 사용합니다.

  • 'TASK'

  • 'USER'

  • 'WAREHOUSE'

사용법 노트

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

    시스템 태그 에 대한 참조를 확인하려면 공유 SNOWFLAKE 데이터베이스에서 IMPORTED PRIVILEGES 를 가진 역할을 사용하십시오.

  • Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수가 정규화된 오브젝트 이름을 사용해야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.

출력

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

데이터 타입

설명

TAG_DATABASE

TEXT

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

TAG_SCHEMA

TEXT

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

TAG_NAME

TEXT

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

TAG_VALUE

TEXT

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

LEVEL

TEXT

태그가 설정된 오브젝트 도메인입니다.

OBJECT_DATABASE

TEXT

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

OBJECT_SCHEMA

TEXT

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

OBJECT_NAME

TEXT

태그 연결이 오브젝트에 있는 경우, 참조 오브젝트의 이름입니다.

DOMAIN

TEXT

태그 연결이 오브젝트에 있는 경우, 참조 오브젝트(예: 테이블, 뷰)의 도메인입니다. 태그 연결이 열에 있는 경우, 도메인은 COLUMN 입니다.

COLUMN_NAME

TEXT

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

my_table 테이블과 연결된 태그 목록을 검색합니다.

select *
  from table(my_db.information_schema.tag_references('my_table', 'table'));
Copy

result 열에서 연결된 태그 목록을 검색합니다.

select *
  from table(my_db.information_schema.tag_references('my_table.result', 'COLUMN'));
Copy