적용 대상:
Databricks SQL Databricks Runtime 16.1 이상
카탈로그, 스키마, 테이블, 뷰, 볼륨, 열, 함수 또는 외부 메타데이터 개체에 태그를 설정합니다.
Important
외부 메타데이터 개체에 태그를 설정하는 것은 공개 미리 보기이며 Databricks Runtime 18.2 이상이 필요합니다.
Unity 카탈로그 보안 개체에 태그를 추가하려면 개체를 소유하거나 다음 권한을 모두 가져야 합니다.
- 개체에 대한
APPLY TAG -
USE SCHEMA개체의 부모 스키마에서 -
USE CATALOG개체의 부모 카탈로그에
외부 메타데이터 개체는 카탈로그 또는 스키마에 포함되지 않으므로 USE CATALOGUSE SCHEMA 적용되지 않습니다.
태그가 관리되는 경우 ASSIGN 태그에 대한 권한도 필요합니다.
문법
SET TAG ON
{ CATALOG catalog_name |
COLUMN relation_name . column_name |
EXTERNAL METADATA external_metadata_name |
{ FUNCTION | PROCEDURE } function_name |
{ SCHEMA | DATABASE } schema_name |
TABLE relation_name |
VIEW relation_name |
VOLUME volume_name }
tag_key [ = tag_value ]
매개 변수
CATALOG catalog_name
태그할 카탈로그의 이름입니다.
COLUMN relation_name . column_name
태그할 열의 정규화된 이름입니다.
relation_name뷰 또는 테이블을 식별해야 합니다.relation_name는 임시 사양이나 옵션 사양를 포함해서는 안 됩니다.외부 메타데이터 external_metadata_name
태그를 지정하는 외부 메타데이터 개체의 이름입니다.
{ FUNCTION | PROCEDURE }function_name태그를 지정하는 함수 또는 프로시저의 이름입니다.
FUNCTION서로PROCEDURE교환할 수 있습니다.SCHEMA schema_name
태그할 스키마의 이름입니다.
TABLE relation_name
태그를 지정하는 테이블 또는 뷰의 이름입니다. 이름에는 임시 사양 또는 옵션 사양이 포함되어서는 안됩니다.
-
태그할 뷰의 이름입니다.
볼륨 volume_name
태그할 볼륨의 이름입니다.
tag_key
식별자입니다. 동일한 키를 가진 태그 할당이 이미 있고 예외가 발생하는 경우
tag_value
선택적 식별자입니다. 지정하지 않으면 태그 할당이 키 전용으로 설정됩니다.
예시
> SET TAG ON CATALOG catalog `cost_center` = `hr`;
> UNSET TAG ON CATALOG catalog cost_center;
> SET TAG ON TABLE catalog.schema.table cost_center = hr;
> UNSET TAG ON TABLE catalog.schema.table cost_center;
> SET TAG ON COLUMN table.ssn pii;
> UNSET TAG ON COLUMN table.ssn pii;
> SET TAG ON FUNCTION catalog.schema.my_func cost_center = hr;
> UNSET TAG ON FUNCTION catalog.schema.my_func cost_center;
> SELECT catalog_name, schema_name, table_name, tag_name, tag_value
FROM information_schema.column_tags
WHERE tag_name = 'pii' AND schema_name = 'default';
table_name column_name
---------- -----------
table ssn