PostgreSQL 22003: 숫자 값이 범위를 벗어남
숫자가 그 타입에 맞지 않습니다: 정수 오버플로우, numeric(p,s)에 너무 큰 값, 또는 int4 한계에 도달한 id 컬럼.
- SQLSTATE
22003- 이름
numeric_value_out_of_range- 카테고리
- 데이터 예외
의미
각 숫자 유형에는 범위가 있습니다: smallint 32767까지, integer 2147483647까지, bigint 약 9.2 × 10^18까지이며, numeric(p, s) 총 p자리, 그중 s자리는 소수점 뒤입니다. 이 범위를 벗어나는 값이나 계산 결과는 22003 오류로 실패합니다. 오류 메시지는 타입 이름을 알려 줍니다: integer out of range, bigint out of range, smallint out of range, 또는 numeric field overflow 대하여 numeric(p, s).
두 정수의 산술 연산은 정수로 이루어지므로 count * price_in_cents 연산은 정수형에서 이뤄지므로 최종 결과가 bigint 열.
일반적인 원인
- A
serial(정수) 기본 키가 2147483647에 도달했으므로nextval열이 담을 수 없는 값을 생성합니다. - 캐스트되기 전에 결과가 정수 범위를 넘는 정수의 곱셈이나 덧셈.
- 다음보다 자릿수가 많은 값
numeric(p, s)예를 들어 1000.00을 허용합니다numeric(5,2)열. - 큰 텍스트나 float 값을 다음 타입으로 캐스팅:
integer또는smallint.
해결 방법
-
열을 넓히세요. 한계에 가까워지는 정수 id라면 다음으로 옮기세요
bigint(테이블을 다시 쓰는 작업이니 미리 계획하세요).ALTER TABLE events ALTER COLUMN id TYPE bigint; ALTER SEQUENCE events_id_seq AS bigint;
-
산술 연산 후가 아니라 그 전에 더 넓은 타입으로 캐스팅하세요.
SELECT qty::bigint * unit_price_cents FROM order_lines;
-
다음 열의 정밀도를 높입니다
numeric(p, s)열.ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
-
시퀀스가 한계에 얼마나 가까운지 확인하세요.
SELECT last_value, max_value FROM pg_sequences WHERE sequencename = 'events_id_seq';
안전하게 재현하세요
SELECT 2147483647 + 1; -- ERROR: integer out of range SELECT 1000::numeric(5, 2); -- ERROR: numeric field overflow
관련 오류
22001타입에 비해 값이 너무 깁니다22P02다음 타입에 대한 잘못된 입력 구문220120으로 나눔8115SQL Server: 변환 중 산술 오버플로 오류1264MySQL: 열의 범위를 벗어난 값ORA-01438Oracle: 지정된 정밀도보다 큰 값입니다
그 밖의 데이터 예외 오류
코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 PostgreSQL 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.