CREATE TYPE

CREATE TYPE

CREATE TYPE 명령은 사용자 정의 유형(user-defined type)을 만드는 명령이에요.

출처: CREATE TYPE

본문

사용자 정의 유형을 만드는 명령입니다. 관련 명령: ALTER TYPE, DESCRIBE TYPE, SHOW TYPES, DROP TYPE, UNDROP TYPE

Syntax

CREATE [ OR REPLACE ] TYPE [ IF NOT EXISTS ] <name> AS <type>
  [ COMMENT = '<string_literal>' ]

Required parameters (필수 파라미터)

  • name — 사용자 정의 유형의 식별자를 지정해요. 사용자 정의 유형이 생성되는 스키마 내에서 고유해야 합니다. 이름은 Snowflake 유형 이름과 같을 수 없어요. 예를 들어 이름이 arraygeometry일 수 없습니다. 이름이 Snowflake 키워드와 같으면 큰따옴표로 지정해야 해요. 또한 식별자는 알파벳 문자로 시작해야 하고, 전체 식별자 문자열을 큰따옴표로 감싸지 않는 한 공백이나 특수 문자를 포함할 수 없어요 (예: "My object"). 큰따옴표로 감싼 식별자는 대소문자를 구분합니다. 자세한 내용은 Identifier requirements 문서를 참고하세요.
  • <type> — 기존 Snowflake 데이터 유형 정의예요. 지정된 유형 정의는 생성되는 사용자 정의 유형의 기본 유형(base type)입니다. type은 다른 사용자 정의 유형일 수 없어요.

Optional parameters (선택 파라미터)

  • COMMENT = '<string_literal>' — 사용자 정의 유형에 대한 주석을 지정해요. 기본값: 값 없음

Access control requirements (접근 제어 요구 사항)

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.

스키마의 객체를 조작하려면 상위 데이터베이스에 대한 권한과 상위 스키마에 대한 권한이 각각 최소 하나씩 필요합니다. 지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.

Usage notes (사용 참고 사항)

사용자 정의 유형은 기존 Snowflake 데이터 유형을 기반으로 만들어요.

Examples (예제)

CREATE TYPE 명령으로 NUMBER 데이터 유형을 기반으로 하는 사용자 정의 유형을 만들어 봅시다.

CREATE TYPE age AS NUMBER(3,0);

OBJECT 데이터 유형을 기반으로 하는 사용자 정의 유형을 만들어 봅시다.

CREATE TYPE path AS OBJECT(
  relative BOOLEAN,
  segments ARRAY(STRING)
);

더 많은 예제는 Examples for user-defined data types 문서를 참고하세요.

더 알아보기 (Learn more)