Menu

PostgreSQL CAST와 :: 연산자로 형 변환하기

PostgreSQL에서 CAST(value AS type)와 value::type은 값을 다른 타입으로 변환합니다. 둘은 같은 변환이며, ::는 PostgreSQL의 짧은 문법입니다.

이 페이지에는 실행 가능한 에디터가 있습니다. 편집하고 실행하면 결과를 바로 볼 수 있습니다.

CAST(value AS type)은 값을 다른 타입으로 변환하고, value::type은 같은 일을 하는 PostgreSQL의 짧은 형태입니다. '42'::integer와 CAST('42' AS integer)는 둘 다 정수 42를 돌려줍니다. 세 번째 형태인 type 'literal'(date '2026-11-17'처럼)은 상수에만 쓸 수 있습니다.

텍스트 '2026-11-17'이 날짜가 되므로 30을 더하면 30일 뒤의 날짜가 나옵니다. 'yes'는 boolean이 받는 표기 중 하나이며, true, t, on, 1도 받습니다.

텍스트를 숫자나 날짜로 변환하기

CSV 파일이나 폼에서 불러온 데이터는 텍스트로 들어오는 경우가 많습니다. 텍스트로 비교하면 '10'이 '9'보다 앞에 정렬되므로, 비교나 계산 전에 캐스트하세요.

정수로 정렬하면 9가 10보다 앞에 오고, 줄 합계는 40.5와 120입니다. 앞뒤 공백은 허용되지만(' 42 '::integer는 동작함), 그 밖의 엉뚱한 글자가 있으면 "invalid input syntax for type integer" 오류가 납니다. '17/11/2026'이나 '1,234.50'처럼 다른 형식의 텍스트는 형식 패턴과 함께 to_date와 to_number를 쓰세요.

반올림과 정수 나눗셈

numeric을 정수로 캐스트하면 0.5는 0에서 먼 쪽으로 반올림됩니다. double precision 값을 캐스트하면 0.5는 가장 가까운 짝수로 반올림됩니다. 정수 나눗셈은 소수 부분을 버립니다.

결과는 3, -3, 2, 4, 3, 3.5, 12입니다. 반올림하지 않고 소수 부분을 잘라 내려면 캐스트 전에 trunc()나 floor()를 쓰세요.

더 작은 타입으로 캐스트하면 범위를 검사합니다. 70000::smallint는 "smallint out of range" 오류로 실패하고, 12.345::numeric(5, 2)는 12.35로 반올림됩니다.

캐스트 전에 입력 검사하기

캐스트가 실패하면 문장 전체가 멈춥니다. PostgreSQL 16부터 pg_input_is_valid(text, type)로 캐스트가 성공할지 검사할 수 있고, pg_input_error_info는 오류를 내지 않고 오류 메시지를 돌려줍니다.

유효한 정수는 '42'뿐입니다. '2026-02-30'은 날짜처럼 보이지만 실제 날짜가 아니므로 valid_date도 false입니다. NULL을 캐스트하면 새 타입의 NULL이 되므로, NULL 행은 모든 컬럼이 NULL입니다.

PostgreSQL이 알아서 캐스트하는 경우

따옴표로 감싼 리터럴은 PostgreSQL이 쓰이는 위치를 볼 때까지 타입이 없습니다. 그래서 WHERE id = '5'와 '1' + 1은 리터럴을 정수로 읽어 동작합니다. 이미 타입이 있는 값은 자동으로 변환되지 않습니다. '1'::text + 1은 "operator does not exist: text + integer" 오류로 실패하고, text 컬럼과 integer 컬럼을 비교해도 마찬가지입니다. 캐스트를 직접 추가하세요.

쓰기는 더 관대합니다. INSERT나 UPDATE는 대입 캐스트가 있으면 값을 컬럼 타입으로 변환하므로, 정수 컬럼에 numeric 12.7을 넣으면 13이 저장됩니다.

컬럼 타입을 아예 바꾸려면 ALTER TABLE ... ALTER COLUMN ... TYPE ... USING으로 모든 행을 한 번 캐스트하세요.

ALTER TABLE imports ALTER COLUMN qty TYPE integer USING qty::integer;

캐스트할 수 있는 타입은 데이터 타입 페이지에 정리되어 있습니다.

자주 묻는 질문

PostgreSQL에서 ::는 무슨 뜻인가요?

PostgreSQL의 캐스트 연산자입니다. '42'::integer는 텍스트 '42'를 정수로 변환합니다. 표준 문법인 CAST('42' AS integer)와 같은 일을 합니다.

PostgreSQL에서 CAST와 :: 중 무엇을 써야 하나요?

동작은 같습니다. ::는 더 짧아 PostgreSQL 코드에서 흔히 씁니다. CAST(... AS ...)는 MySQL, SQL Server, SQLite도 받는 표준 SQL이므로, 이식성이 필요한 쿼리에서는 이것을 쓰세요.

텍스트가 숫자가 아닐 때 오류 없이 변환하려면 어떻게 하나요?

먼저 검사하세요. PostgreSQL 16부터 pg_input_is_valid('4x2', 'integer')는 오류 대신 false를 돌려주므로, CASE WHEN pg_input_is_valid(s, 'integer') THEN s::integer END는 잘못된 입력에 NULL을 줍니다. 이전 버전에서는 s ~ '^-?\d+$' 같은 정규식으로 먼저 텍스트를 검사하세요.

PostgreSQL에서 7 / 2가 3인 이유는 무엇인가요?

정수끼리 나누면 결과도 정수이고 소수 부분이 버려집니다. 3.5를 얻으려면 한쪽을 numeric으로 캐스트하세요. 7::numeric / 2처럼 씁니다.

Coddy 프로그래밍 언어 일러스트

Coddy로 코딩 배우기

시작하기