카테고리:: 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'

사용법 노트¶

지정된 오브젝트에 대한 액세스 권한이 있는 역할에 대해서만 결과가 반환됩니다.
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