- 카테고리:
SYSTEM$GET_TAG¶
지정된 Snowflake 오브젝트 또는 열과 연결된 태그 값을 반환합니다. 지정된 Snowflake 오브젝트 또는 열에 태그가 설정되어 있지 않으면 NULL을 반환합니다.
구문¶
SYSTEM$GET_TAG( '<tag_name>' , '<obj_name>' , '<obj_domain>' )
인자¶
'tag_name'
문자열로서의 태그의 이름입니다.
이름은 태그의 키-값 페어에 있는
key
입니다. 예를 들어,cost_center = 'sales'
태그에서cost_center
는 태그의 키 이름입니다. 이 인자의 경우,'cost_center'
를 사용합니다.'obj_name'
문자열로서의 오브젝트의 이름입니다.
예를 들어, 테이블 이름이
my_table
인 경우, 오브젝트 이름으로'my_table'
을 사용합니다.열을 지정하려면
<테이블_이름>.<열_이름>
형식을 사용합니다. 예:my_table.revenue
.자세한 내용은 오브젝트 식별자 섹션을 참조하십시오.
'object_domain'
태그 연결이 오브젝트에 있는 경우 참조 오브젝트(예: 테이블 또는 뷰)의 도메인입니다. 열의 경우, 태그 연결이 열에 있으면 도메인은
COLUMN
입니다.다음 값 중 하나를 사용합니다.
'ACCOUNT'
'ALERT'
'COLUMN'
'DATABASE'
'DATABASE ROLE'
'FUNCTION'
'INTEGRATION'
'NETWORK POLICY'
'PROCEDURE'
'ROLE'
'SCHEMA'
'SHARE'
'STAGE'
'STREAM'
'TABLE'
: 뷰, 구체화된 뷰, 외부 테이블 등 모든 테이블 형식 오브젝트에 이 값을 사용합니다.'TASK'
'USER'
'WAREHOUSE'
사용법 노트¶
이 함수를 사용하려면 다음이 필요합니다.
지정된 오브젝트 이름에 대해 DESCRIBE <오브젝트> 작업을 실행할 수 있는 권한.
태그가 있는 데이터베이스 및 스키마의 USAGE.
자세한 내용은 태그 권한 및 DDL 요약 을 참조하십시오.
시스템 태그 를 지정하는 경우 공유 SNOWFLAKE 데이터베이스에 대한 IMPORTED PRIVILEGES.
예¶
지정된 오브젝트에 태그가 연결되어 있지 않은 경우, NULL
을 반환합니다.
select system$get_tag('cost_center', 'my_table', 'table'); +-----------------------------------------------------+ | SYSTEM$GET_TAG('COST_CENTER', 'MY_TABLE', 'TABLE') | +-----------------------------------------------------+ | NULL | +-----------------------------------------------------+
지정된 테이블에 대한 태그 값을 반환합니다. 태그 값은 태그에서 key = 'value'
쌍의 문자열 구성 요소입니다.
select system$get_tag('cost_center', 'my_table', 'table'); -----------------------------------------------------+ | SYSTEM$GET_TAG('COST_CENTER', 'MY_TABLE', 'TABLE') | +----------------------------------------------------+ | sales | +----------------------------------------------------+
지정된 열에 대한 태그 값을 반환합니다.
select system$get_tag('fiscal_quarter', 'my_table.revenue', 'column'); +----------------------------------------------------------------+ | SYSTEM$GET_TAG('FISCAL_QUARTER', 'MY_TABLE.REVENUE', 'COLUMN') | +----------------------------------------------------------------+ | Q1 | +----------------------------------------------------------------+