// 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) 小数点以下 s 桁を含む最大 p 桁。範囲外の値または計算結果は 22003 で失敗します。メッセージには型名が示されます: integer out of range, bigint out of range, smallint out of range、または numeric field overflow 向け numeric(p, s).

2 つの整数の算術演算は整数で行われるため、 count * price_in_cents 最終的な答えが次に格納される場合でも、オーバーフローすることがあります bigint 列。

よくある原因

  • A serial (整数型)の主キーが 2147483647 に達したため、 nextval 列が保持できない値を生成します。
  • キャストされる前に結果が整数の範囲を超えてしまう、整数の乗算または合計。
  • 次より桁数の多い値 numeric(p, s) たとえば、1000.00を次の中で許可します numeric(5,2) 列。
  • 大きなテキスト値または浮動小数点値を次の型にキャストしている: 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 を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。