카테고리:

시스템 함수

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.

자세한 내용은 오브젝트 식별자 섹션을 참조하십시오.

'obj_domain'

문자열로서의 오브젝트의 도메인(예: TABLE, WAREHOUSE)입니다. 테이블이나 뷰 열에 태그가 할당된 경우 도메인은 COLUMN 입니다.

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

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

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

사용법 노트

  • 이 함수를 사용하려면 다음이 필요합니다.

지정된 오브젝트에 태그가 연결되어 있지 않은 경우, 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                                                             |
+----------------------------------------------------------------+
맨 위로 이동