카테고리:

시스템 함수

SYSTEM$GET_TAG

지정된 Snowflake 오브젝트 또는 열과 연결된 태그 값을 반환합니다. 지정된 Snowflake 오브젝트 또는 열에 태그가 설정되어 있지 않으면 NULL을 반환합니다.

구문

SYSTEM$GET_TAG( '<tag_name>' , '<obj_name>' , '<obj_domain>' )
Copy

인자

'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                                                |
+-----------------------------------------------------+
Copy

지정된 테이블에 대한 태그 값을 반환합니다. 태그 값은 태그에서 key = 'value' 쌍의 문자열 구성 요소입니다.

select system$get_tag('cost_center', 'my_table', 'table');

-----------------------------------------------------+
| SYSTEM$GET_TAG('COST_CENTER', 'MY_TABLE', 'TABLE') |
+----------------------------------------------------+
| sales                                              |
+----------------------------------------------------+
Copy

지정된 열에 대한 태그 값을 반환합니다.

select system$get_tag('fiscal_quarter', 'my_table.revenue', 'column');

+----------------------------------------------------------------+
| SYSTEM$GET_TAG('FISCAL_QUARTER', 'MY_TABLE.REVENUE', 'COLUMN') |
+----------------------------------------------------------------+
| Q1                                                             |
+----------------------------------------------------------------+
Copy