관리 태그 만들기

적용 대상:yes Databricks SQL 확인 표시 예 Databricks Runtime 18.1 이상 확인 표시 예 Unity 카탈로그만 표시

계정 수준 리소스인 관리 태그를 만듭니다.

이 문을 실행하려면 계정 수준에서 권한이 있어야 합니다 CREATE . 계정 관리자 및 작업 영역 관리자는 기본적으로 이 권한을 갖습니다.

문법

CREATE GOVERNED TAG tag_key [ DESCRIPTION description ] [ VALUES ( value_name [, ...] ) ]

매개 변수

  • tag_key

    제어된 것으로 표시할 태그 키입니다. 태그 키는 계정 내에서 고유해야 하며 대/소문자를 구분합니다. 이 태그 키가 있는 관리 태그가 이미 있는 경우 Azure Databricks ALREADY_EXISTS 오류를 반환합니다.

  • 설명 설명

    선택적 STRING 리터럴입니다. 관리 태그에 대한 설명입니다.

  • VALUES ( value_name [, ...] )

    제어 태그에 허용되는 값을 설정합니다. 관리 태그는 키 전용 할당 또는 미리 정의된 값 목록을 지원합니다. 빈 목록으로 지정하거나 완전히 생략하는 경우 제어 태그는 키 전용 태그 할당만 허용합니다.

    • value_name

      STRING 리터럴입니다. 허용되는 값의 이름입니다. 대 / 소문자.

요구 사항

태그 키 및 태그 값:

  • 최대 256자까지 가능합니다.
  • 국제 문자, 기호 및 이모지와 같은 유니코드 문자를 포함하여 UTF-8 인코딩을 지원합니다.
  • 대/소문자를 구분합니다. 예를 들어 Departmentdepartment 두 개의 고유 태그입니다.
  • 다음 문자를 * . / < > % & ? \ = 포함할 수 없습니다. 또는 컨트롤 문자(ASCII 0-31)
  • 공백으로 시작하거나 끝낼 수 없습니다.

예제

-- Create a key-only governed tag.
> CREATE GOVERNED TAG isPii;

-- Create a governed tag with an empty values list.
> CREATE GOVERNED TAG sensitivity_level VALUES ();

-- Create a governed tag with allowed values.
> CREATE GOVERNED TAG sensitivity_level VALUES ('low', 'medium', 'high');

-- Create a governed tag with a description and allowed values.
> CREATE GOVERNED TAG pii
  DESCRIPTION 'Indicates what kind of personal identifiable information the asset contains'
  VALUES ('ssn', 'ccn', 'dob');