카테고리:

Information Schema , 테이블 함수

TAG_REFERENCES

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

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

구문

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

인자

'object_name'

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

'object_domain'

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

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

ACCOUNT | INTEGRATION | ROLE | SHARE | USER | WAREHOUSE | DATABASE | SCHEMA | PROCEDURE | STAGE | STREAM | TABLE | TASK | COLUMN

TABLE 의 도메인 값은 뷰, 구체화된 뷰, 외부 테이블 등 테이블과 유사한 모든 오브젝트에 사용해야 합니다.

사용법 노트

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

  • 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'));

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

select *
  from table(my_db.information_schema.tag_references('my_table.result', 'COLUMN'));
맨 위로 이동