최종 수정: 2026년 9월 15일에

타입 변환

Doris에서 각 표현식에는 타입이 있습니다. 예를 들어 1, col1, from_unixtime(col2)는 select 1, col1, from_unixtime(col2) from table1에 포함된 표현식으로, 각각 타입이 있습니다. 표현식을 한 타입에서 다른 타입으로 변환하는 과정을 "타입 변환"이라고 합니다.

타입 변환은 명시적 변환과 암시적 변환의 두 가지 경우에 발생합니다.

모든 타입 변환은 정해진 규칙을 따릅니다. 관련 규칙은 변환의 대상 타입을 기준으로 설명합니다. 예를 들어 INT에서 DOUBLE로의 변환과 STRING에서 DOUBLE로의 변환은 모두 FLOAT/DOUBLE로 변환 문서에서 설명합니다.

변환 가능 여부와 결과가 Nullable 타입인지 여부는 엄격 모드(세션 변수 enable_strict_cast)의 활성화 여부에 따라 달라집니다. 일반적으로 엄격 모드가 활성화된 경우, 변환에 실패하는 데이터가 있으면 즉시 오류가 발생하고 SQL 실행이 실패합니다. 엄격 모드가 비활성화된 경우, 변환에 실패한 데이터 행은 NULL이 됩니다.

파싱 및 마이그레이션 규칙은 UUID 변환을 참조하세요. 문자열을 UUID로 변환할 수 있으며, UUID를 문자열이나 VARIANT로 변환할 수 있습니다. 단, 숫자, 날짜/시간 또는 IP 타입으로는 직접 변환할 수 없습니다.

명시적 변환

명시적 변환은 CAST 함수를 통해 수행합니다. 예를 들면 다음과 같습니다.

CAST(1.23 as INT)는 숫자 1.23을 INT 타입으로 변환합니다.

CAST(colA as DATETIME(6))는 컬럼/표현식 colA를 DATETIME(6) 타입(마이크로초 정밀도를 지원하는 DATETIME 타입)으로 변환합니다.

다음은 엄격 모드(enable_strict_cast = true)와 비엄격 모드(enable_strict_cast = false)에서 서로 다른 타입 간의 타입 변환 관계를 설명하며, 다음 네 가지 경우를 포함합니다.

기호	의미
x	변환할 수 없음
P	입력 매개변수가 이미 Nullable 타입인 경우에만 반환 타입이 Nullable이 됩니다. 즉, 이 변환은 Null이 아닌 값을 Null로 변환하지 않습니다
A	반환 타입은 항상 Nullable입니다. 이 변환은 Null이 아닌 값을 Null로 변환할 수 있습니다
O	입력 타입에서 출력 타입으로 변환할 때 오버플로가 발생할 수 있는 경우 반환 타입이 Nullable이 됩니다. Null이 아닌 입력 값을 변환할 때 실제로 오버플로가 발생하면 변환 결과가 Null이 될 수 있습니다

구체적인 타입 변환 규칙과 Nullable 속성은 현재 디렉터리의 타입 변환 문서를 참조하세요.

엄격 모드

원본\대상	bool	tinyint	smallint	int	bigint	largeint	float	double	decimal	date	datetime	timestamp_ns	time	IPv4	IPv6	char	varchar	string	bitmap	hll	json	array	map	struct	variant	UUID
bool	P	P	P	P	P	P	P	P	O	x	x	x	x	x	x				x	x	P	x	x	x		x
tinyint	P	P	P	P	P	P	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
smallint	P	A	P	P	P	P	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
int	P	A	A	P	P	P	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
bigint	P	A	A	A	P	P	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
largeint	P	A	A	A	A	P	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
float	P	A	A	A	A	A	P	P	A	A	A	A	A	x	x				x	x	P	x	x	x		x
double	P	A	A	A	A	A	P	P	A	A	A	A	A	x	x				x	x	P	x	x	x		x
decimal	P	O	O	O	O	O	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
date	x	x	x	P	P	P	x	x	x	P	P	A	x	x	x				x	x	x	x	x	x		x
datetime	x	x	x	x	P	P	x	x	x	P	A	A	P	x	x				x	x	x	x	x	x		x
timestamp_ns	x	x	x	x	P	P	x	x	x	P	P	P	P	x	x	P	P	P	x	x	x	x	x	x	P	x
time	x	A	A	A	P	P	x	x	x	P	P	P	A	x	x				x	x	x	x	x	x		x
IPv4	x	x	x	x	x	x	x	x	x	x	x	x	x	P	P				x	x	x	x	x	x		x
IPv6	x	x	x	x	x	x	x	x	x	x	x	x	x	x	P				x	x	x	x	x	x		x
char	A	A	A	A	A	A	A	A	A	A	A	A	A	A	A				x	x	A	A	A	A		A
varchar	A	A	A	A	A	A	A	A	A	A	A	A	A	A	A				x	x	A	A	A	A		A
string	A	A	A	A	A	A	A	A	A	A	A	A	A	A	A				x	x	A	A	A	A		A
bitmap	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	P	x	x	x	x	x		x
hll	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	P	x	x	x	x		x
json	A	A	A	A	A	A	A	A	A	x	x	x	x	x	x	A	A	A	x	x	P	A	x	A		x
array	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x				x	x	P	P	x	x		x
map	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x				x	x	x	x	P	x		x
struct	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x				x	x	P	x	x	P		x
variant												A														A
UUID	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	P	P	P	x	x	x	x	x	x	P	P

비엄격 모드

원본\대상	bool	tinyint	smallint	int	bigint	largeint	float	double	decimal	date	datetime	timestamp_ns	time	IPv4	IPv6	char	varchar	string	bitmap	hll	json	array	map	struct	variant	UUID
bool	P	P	P	P	P	P	P	P	O	x	x	x	x	x	x				x	x	P	x	x	x		x
tinyint	P	P	P	P	P	P	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
smallint	P	A	P	P	P	P	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
int	P	A	A	P	P	P	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
bigint	P	A	A	A	P	P	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
largeint	P	A	A	A	A	P	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
float	P	A	A	A	A	A	P	P	A	A	A	A	A	x	x				x	x	P	x	x	x		x
double	P	A	A	A	A	A	P	P	A	A	A	A	A	x	x				x	x	P	x	x	x		x
decimal	P	O	O	O	O	O	P	P	O	A	A	A	A	x	x				x	x	P	x	x	x		x
date	x	x	x	P	P	P	P	P	x	P	P	A	x	x	x				x	x	x	x	x	x		x
datetime	x	x	x	x	P	P	P	P	x	P	A	A	P	x	x				x	x	x	x	x	x		x
timestamp_ns	x	x	x	x	P	P	P	P	x	P	P	P	P	x	x	P	P	P	x	x	x	x	x	x	P	x
time	x	A	A	A	P	P	P	P	x	P	P	P	A	x	x				x	x	x	x	x	x		x
IPv4	x	x	x	x	x	x	x	x	x	x	x	x	x	P	P				x	x	x	x	x	x		x
IPv6	x	x	x	x	x	x	x	x	x	x	x	x	x	x	P				x	x	x	x	x	x		x
char	A	A	A	A	A	A	A	A	A	A	A	A	A	A	A				x	x	A	A	A	A		A
varchar	A	A	A	A	A	A	A	A	A	A	A	A	A	A	A				x	x	A	A	A	A		A
string	A	A	A	A	A	A	A	A	A	A	A	A	A	A	A				x	x	A	A	A	A		A
bitmap	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	P	x	x	x	x	x		x
hll	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	P	x	x	x	x		x
json	A	A	A	A	A	A	A	A	A	x	x	x	x	x	x	A	A	A	x	x	P	A	x	A		x
array	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x				x	x	P	P	x	x		x
map	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x				x	x	x	x	P	x		x
struct	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x				x	x	P	x	x	P		x
variant												A														A
UUID	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	P	P	P	x	x	x	x	x	x	P	P

TIMESTAMP_NS의 자세한 변환 규칙은 TIMESTAMP_NS로 변환을 참조하세요. TIMESTAMPTZ는 위 행렬에 포함되어 있지 않습니다. TIMESTAMP_NS와 TIMESTAMPTZ 간 변환은 엄격 모드와 비엄격 모드 모두에서 지원됩니다.

암시적 변환

암시적 변환은 입력 SQL에 명시되어 있지 않더라도 Doris가 자동으로 CAST 표현식을 계획하는 특정 상황에서 발생합니다. 주로 다음과 같은 경우에 발생합니다.

함수를 호출할 때 실제 매개변수의 타입이 함수 시그니처의 타입과 일치하지 않는 경우.
수학 표현식 양쪽의 타입이 서로 다른 경우.

등이 있습니다.

변환 행렬

TODO

공통 타입

피연산자를 수학 연산에 사용하여 암시적 변환이 필요한 경우, 먼저 공통 타입을 결정합니다. 양쪽 피연산자의 타입이 공통 타입과 일치하지 않으면, 각 피연산자를 공통 타입으로 변환하는 CAST 표현식이 계획됩니다.

비교, CASE, COALESCE 또는 집합 연산에서 문자열과 UUID에 공통 타입이 필요한 경우, 공통 타입은 UUID이며 문자열을 UUID 텍스트로 파싱합니다. 유효하지 않은 문자열에는 CAST 규칙이 적용됩니다. UUID는 숫자 산술 연산의 공통 타입 추론에 참여하지 않습니다.

명시적 변환​

엄격 모드​

비엄격 모드​

암시적 변환​

변환 행렬​

공통 타입​