// PostgreSQL 오류 참조

PostgreSQL 22003: 숫자 값이 범위를 벗어남

숫자가 그 타입에 맞지 않습니다: 정수 오버플로우, numeric(p,s)에 너무 큰 값, 또는 int4 한계에 도달한 id 컬럼.

SQLSTATE
22003
이름
numeric_value_out_of_range
카테고리
데이터 예외
오류 메시지
integer 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.

해결 방법

  1. 열을 넓히세요. 한계에 가까워지는 정수 id라면 다음으로 옮기세요 bigint (테이블을 다시 쓰는 작업이니 미리 계획하세요).

    ALTER TABLE events ALTER COLUMN id TYPE bigint;
    ALTER SEQUENCE events_id_seq AS bigint;
  2. 산술 연산 후가 아니라 그 전에 더 넓은 타입으로 캐스팅하세요.

    SELECT qty::bigint * unit_price_cents FROM order_lines;
  3. 다음 열의 정밀도를 높입니다 numeric(p, s) 열.

    ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
  4. 시퀀스가 한계에 얼마나 가까운지 확인하세요.

    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

관련 오류

그 밖의 데이터 예외 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.