본문으로 건너뛰기
최종 수정: 에

데이터 타입

Apache Doris에서 지원하는 데이터 타입은 다음과 같습니다:

숫자 타입​

타입 이름저장 크기(바이트)설명
BOOLEAN1Boolean 값입니다. 0은 false를, 1은 true를 나타냅니다.
TINYINT1부호 있는 정수이며, 범위는 [-128, 127]입니다.
SMALLINT2부호 있는 정수이며, 범위는 [-32768, 32767]입니다.
INT4부호 있는 정수이며, 범위는 [-2147483648, 2147483647]입니다.
BIGINT8부호 있는 정수이며, 범위는 [-9223372036854775808, 9223372036854775807]입니다.
LARGEINT16부호 있는 정수이며, 범위는 [-2^127 + 1 ~ 2^127 - 1]입니다.
FLOAT4부동 소수점 수이며, 범위는 [-3.410^38 ~ 3.410^38]입니다.
DOUBLE8부동 소수점 수이며, 범위는 [-1.7910^308 ~ 1.7910^308]입니다.
DECIMAL4/8/16/32고정밀 고정 소수점 수입니다. 형식: DECIMAL(P[,S]). P는 전체 유효 자릿수(정밀도)를, S는 소수점 이하 자릿수(스케일)를 나타냅니다. P의 범위는 [1, MAX_P]입니다. enable_decimal256=false이면 MAX_P=38이고, enable_decimal256=true이면 MAX_P=76입니다. S의 범위는 [0, P]입니다.
enable_decimal256의 기본값은 false입니다. true로 설정하면 더 정밀한 결과를 얻을 수 있지만 성능 오버헤드가 발생합니다.
저장 크기:
  • 0 < precision <= 9이면 4바이트를 차지합니다.
  • 9 < precision <= 18이면 8바이트를 차지합니다.
  • 18 < precision <= 38이면 16바이트를 차지합니다.
  • 38 < precision <= 76이면 32바이트를 차지합니다.

날짜 타입​

타입 이름저장 크기(바이트)설명
DATE4날짜 타입입니다. 현재 값의 범위는 ['0000-01-01', '9999-12-31']이며, 기본 출력 형식은 'yyyy-MM-dd'입니다.
DATETIME8날짜 및 시간 타입입니다. 형식: DATETIME([P]). 선택적 매개변수 P는 시간 정밀도를 나타내며, 값의 범위는 [0, 6]입니다. 즉, 소수점 이하 최대 6자리(마이크로초)까지 지원합니다. 설정하지 않으면 기본값은 0입니다.
값의 범위는 ['0000-01-01 00:00:00[.000000]', '9999-12-31 23:59:59[.999999]']입니다. 출력 형식은 'yyyy-MM-dd HH:mm:ss.SSSSSS'입니다.

문자열 타입​

타입 이름저장 크기(바이트)설명
CHARM고정 길이 문자열입니다. M은 고정 길이 문자열의 바이트 길이를 나타냅니다. M의 범위는 1-255입니다.
VARCHAR가변가변 길이 문자열입니다. M은 가변 길이 문자열의 바이트 길이를 나타냅니다. M의 범위는 1-65533입니다. 가변 길이 문자열은 UTF-8 인코딩으로 저장되므로, 영문자는 일반적으로 1바이트를 차지하고 한자는 3바이트를 차지합니다.
STRING가변가변 길이 문자열입니다. 기본적으로 1048576바이트(1MB)를 지원하며, 최대 2147483643바이트(2GB)까지 늘릴 수 있습니다. BE 설정 string_type_length_soft_limit_bytes로 조정할 수 있습니다. String 타입은 Value 컬럼에만 사용할 수 있으며, Key 컬럼이나 파티션/버킷팅 컬럼에는 사용할 수 없습니다.

반정형 타입​

타입 이름저장 크기(바이트)설명
ARRAY가변T 타입의 요소로 구성된 배열입니다. Key 컬럼으로 사용할 수 없습니다. 현재 Duplicate 및 Unique 모델의 테이블에서 지원됩니다.
MAP가변K 및 V 타입의 요소로 구성된 맵입니다. Key 컬럼으로 사용할 수 없습니다. 현재 Duplicate 및 Unique 모델의 테이블에서 지원됩니다.
STRUCT가변여러 필드로 구성된 struct이며, 여러 컬럼의 모음으로도 볼 수 있습니다. Key로 사용할 수 없습니다. 현재 STRUCT는 Duplicate 모델의 테이블에서만 지원됩니다. Struct의 필드 이름과 개수는 고정되어 있으며, 필드는 항상 Nullable입니다.
JSON가변바이너리 JSON 타입입니다. 바이너리 JSON 형식으로 저장되며, JSON 내부 필드는 JSON 함수를 통해 접근합니다. 길이 제한과 설정 방법은 String과 같습니다.
VARIANT가변JSON과 같은 반정형 데이터를 위해 설계된, 동적으로 변하는 데이터 타입입니다. 모든 JSON을 저장할 수 있으며, JSON의 필드를 자동으로 하위 컬럼으로 분리해 저장하여 저장 효율과 쿼리 분석 성능을 높입니다. 길이 제한과 설정 방법은 String과 같습니다. Variant 타입은 Value 컬럼에만 사용할 수 있으며, Key 컬럼이나 파티션/버킷팅 컬럼에는 사용할 수 없습니다.

집계 타입​

타입 이름저장 크기(바이트)설명
HLL가변HLL은 근사 중복 제거에 사용됩니다. 데이터가 많을 때는 Count Distinct보다 성능이 좋습니다. HLL의 오차는 일반적으로 1% 정도이며, 때로는 2%에 이르기도 합니다. HLL은 Key 컬럼으로 사용할 수 없으며, 테이블 생성 시 집계 타입으로 HLL_UNION을 지정해야 합니다. 사용자가 길이와 기본값을 지정할 필요는 없습니다. 길이는 데이터의 집계 정도에 따라 시스템에서 내부적으로 제어합니다. HLL 컬럼은 해당 hll_union_agg, hll_raw_agg, hll_cardinality, hll_hash 함수를 통해서만 쿼리하거나 사용할 수 있습니다.
BITMAP가변Bitmap 타입의 컬럼은 Aggregate 테이블, Unique 테이블 또는 Duplicate 테이블에서 사용할 수 있습니다. Unique 테이블이나 Duplicate 테이블에서 사용할 때는 Key가 아닌 컬럼으로 사용해야 합니다. Aggregate 테이블에서 사용할 때는 Key가 아닌 컬럼으로 사용해야 하며, 테이블 생성 시 집계 타입으로 BITMAP_UNION을 지정해야 합니다. 사용자가 길이와 기본값을 지정할 필요는 없습니다. 길이는 데이터의 집계 정도에 따라 시스템에서 내부적으로 제어합니다. BITMAP 컬럼은 해당 bitmap_union_count, bitmap_union, bitmap_hash, bitmap_hash64 등의 함수를 통해서만 쿼리하거나 사용할 수 있습니다.
QUANTILE_STATE가변QUANTILE_STATE는 근사 분위수 값을 계산하는 데 사용하는 타입입니다. 데이터 적재 시 동일한 Key에 대한 서로 다른 Value를 미리 집계합니다. 값의 개수가 2048을 넘지 않으면 모든 데이터를 상세히 기록합니다. 값의 개수가 2048을 넘으면 TDigest 알고리즘으로 데이터를 집계(클러스터링)하고, 클러스터링 후의 중심점을 저장합니다. QUANTILE_STATE는 Key 컬럼으로 사용할 수 없으며, 테이블 생성 시 집계 타입으로 QUANTILE_UNION을 지정해야 합니다. 사용자가 길이와 기본값을 지정할 필요는 없습니다. 길이는 데이터의 집계 정도에 따라 시스템에서 내부적으로 제어합니다. QUANTILE_STATE 컬럼은 해당 QUANTILE_PERCENT, QUANTILE_UNION, TO_QUANTILE_STATE 등의 함수를 통해서만 쿼리하거나 사용할 수 있습니다.
AGG_STATE가변집계 함수입니다. state/merge/union 함수 조합자와 함께만 사용할 수 있습니다. AGG_STATE는 Key 컬럼으로 사용할 수 없으며, 테이블 생성 시 집계 함수의 시그니처도 함께 선언해야 합니다. 사용자가 길이와 기본값을 지정할 필요는 없습니다. 실제 저장 데이터의 크기는 함수 구현에 따라 달라집니다.

IP 타입​

타입 이름저장 크기(바이트)설명
IPv44바이트IPv4 주소를 4바이트의 바이너리 데이터로 저장하며, ipv4_* 계열 함수와 함께 사용합니다.
IPv616바이트IPv6 주소를 16바이트의 바이너리 데이터로 저장하며, ipv6_* 계열 함수와 함께 사용합니다.

SHOW DATA TYPES; 문으로도 Apache Doris에서 지원하는 모든 데이터 타입을 확인할 수 있습니다.

Report issue