CREATE TAG

새 태그를 만들거나 시스템의 기존 태그를 바꿉니다.

참고 항목:

태그 값 지정하기 , TAGS 뷰 , 태그 DDL 참조

구문

CREATE [ OR REPLACE ] TAG [ IF NOT EXISTS ] <name> [ COMMENT = '<string_literal>' ]

CREATE [ OR REPLACE ] TAG [ IF NOT EXISTS ] <name>
    [ ALLOWED_VALUES '<val_1>' [ , '<val_2>' [ , ... ] ] ]
Copy

필수 매개 변수

name

태그의 식별자입니다. CREATE <오브젝트> 문 또는 ALTER <오브젝트> 문을 사용하여 오브젝트 에 태그 문자열 값을 할당합니다.

식별자 값은 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예: “My object”)로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

선택적 매개 변수

ALLOWED_VALUES 'val_1' [ , 'val_2' [ , ... ] ]

해당 CREATE <오브젝트> 또는 ALTER <오브젝트> 명령을 사용하여 오브젝트 에 태그를 설정할 때 태그에 할당할 수 있는 가능한 문자열 값으로 이루어진, 쉼표로 구분된 목록을 지정합니다.

이 목록의 최대 태그 값 수는 300개입니다.

기본값: NULL(빈 문자열 값(즉, ' ')을 포함한 모든 문자열 값이 허용됨).

COMMENT = 'string_literal'

태그에 대한 설명을 지정합니다.

기본값: 값 없음

액세스 제어 요구 사항

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한

오브젝트

참고

CREATE TAG

스키마

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

태그 DDL 및 권한에 대한 추가적인 세부 사항은 태그 관리하기 섹션을 참조하십시오.

사용법 노트

  • Snowflake는 계정의 태그 수를 10,000개로 제한합니다.

  • 태그를 Snowflake 오브젝트에 연결하는 방법에 대한 자세한 내용은 오브젝트 태그 지정 을 참조하십시오.

  • 태그 DDL 인증에 대한 자세한 내용은 필수 권한 을 참조하십시오.

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

  • CREATE OR REPLACE <오브젝트> 문은 원자성입니다. 즉, 오브젝트가 바뀔 때 단일 트랜잭션으로 이전 오브젝트가 삭제되고 새 오브젝트가 생성됩니다.

cost_center 키를 사용하여 태그를 만듭니다.

CREATE TAG cost_center COMMENT = 'cost_center tag';
Copy