DESCRIBE TYPE

DESCRIBE TYPE

사용자 정의 유형(User-Defined Type)을 설명하는 명령어입니다. DESCRIBE는 DESC로 줄여서 쓸 수 있어요.

출처: 문서

본문

DESCRIBE TYPE은 사용자 정의 유형을 설명합니다. 관련 명령어로 CREATE TYPE, ALTER TYPE, SHOW TYPES, DROP TYPE, UNDROP TYPE이 있어요.

구문 (Syntax)

{ DESC | DESCRIBE } TYPE <name>

파라미터 (Parameters)

• name — 설명할 사용자 정의 유형의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요. 자세한 내용은 Identifier requirements를 참고하세요.

출력 (Output)

명령어 출력은 다음 컬럼으로 사용자 정의 유형의 속성과 메타데이터를 제공합니다.

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

이 작업을 실행하는 역할은 최소한 다음 권한 중 하나가 있어야 합니다: ANY (객체: User-defined type).

스키마 안의 객체를 조작하려면 상위 데이터베이스에 대한 권한이 1개 이상, 상위 스키마에 대한 권한이 1개 이상 필요합니다. 지정된 권한 집합으로 커스텀 역할을 만드는 방법은 Creating custom roles을, securable 객체에 대한 역할과 권한 부여에 관한 일반 정보는 Overview of Access Control을 참고하세요.

사용 참고 사항 (Usage notes)

• 이 명령어의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 방식 모두 출력을 조회 가능한 결과 집합으로 취급합니다. 예를 들어 SHOW 명령어 출력에서 원하는 컬럼만 선택하거나 행을 필터링할 수 있어요.
• 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표 식별자로 사용하세요. 예를 들어 출력 컬럼 type을 선택하려면 SELECT "type"처럼 지정합니다. SHOW 명령어의 출력 컬럼 이름은 소문자이므로 큰따옴표 식별자를 반드시 사용해야 해요.

예제 (Examples)

DESCRIBE TYPE 명령어를 사용해 age 사용자 정의 유형에 대한 세부 정보를 나열합니다.

DESC TYPE age;

+------+-------------+-------------------------------+---------------+-------------+--------------+---------+
| name | type        | created_on                    | database_name | schema_name | owner        | comment |
|------+-------------+-------------------------------+---------------+-------------+--------------+---------|
| AGE  | NUMBER(3,0) | 2025-11-06 09:23:59.882 -0800 | MY_DB         | MY_SCHEMA   | MY_ROLE      | NULL    |
+------+-------------+-------------------------------+---------------+-------------+--------------+---------+

더 알아보기 (Learn more)

• CREATE TYPE
• ALTER TYPE
• SHOW TYPES
• DROP TYPE
• UNDROP TYPE