// PostgreSQL-Fehlerreferenz

PostgreSQL 22003: numerischer Wert außerhalb des Bereichs

Eine Zahl passt nicht zu ihrem Typ: ein Integer-Überlauf, ein Wert zu groß für numeric(p,s) oder eine ID-Spalte, die das int4-Limit erreicht hat.

SQLSTATE
22003
Name
numeric_value_out_of_range
Kategorie
Daten-Ausnahme
Fehlermeldung
integer out of range

Was es bedeutet

Jeder numerische Typ hat einen Wertebereich: smallint bis zu 32767, integer bis zu 2147483647, bigint bis zu ungefähr 9,2 × 10^18, und numeric(p, s) bis zu p Stellen mit s nach dem Komma. Ein Wert oder ein Berechnungsergebnis außerhalb des Bereichs schlägt mit 22003 fehl. Die Nachricht nennt den Typ: integer out of range, bigint out of range, smallint out of range, oder numeric field overflow für numeric(p, s).

Arithmetik bei zwei ganzen Zahlen wird als Ganzzahl durchgeführt, also count * price_in_cents kann überlaufen, selbst wenn die endgültige Antwort in einem bigint Spalte hinzu.

Häufige Ursachen

  • A serial (integer) Primärschlüssel gespeichert wird, der 2147483647 erreicht hat, sodass nextval einen Wert erzeugt, den die Spalte nicht aufnehmen kann.
  • Multiplizieren oder Summieren von Ganzzahlen, deren Ergebnis den Ganzzahlbereich überschreitet, bevor es konvertiert wird.
  • Ein Wert mit mehr Ziffern, als numeric(p, s) erlaubt, zum Beispiel 1000,00 in einem numeric(5,2) Spalte hinzu.
  • Umwandeln eines großen Text- oder Gleitkommawerts in integer oder smallint.

Wie du es behebst

  1. Verbreitere die Spalte; bei einer integer id, die zur Neige geht, wechsle zu bigint (dies schreibt die Tabelle um, also plane das ein).

    ALTER TABLE events ALTER COLUMN id TYPE bigint;
    ALTER SEQUENCE events_id_seq AS bigint;
  2. Vor der Arithmetik zu einem breiteren Typ konvertieren, nicht danach.

    SELECT qty::bigint * unit_price_cents FROM order_lines;
  3. Die Genauigkeit einer numeric(p, s) Spalte hinzu.

    ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
  4. Prüfe, wie nah eine Sequenz an ihrem Limit ist.

    SELECT last_value, max_value FROM pg_sequences WHERE sequencename = 'events_id_seq';

Sicher reproduzieren

SELECT 2147483647 + 1;      -- ERROR: integer out of range
SELECT 1000::numeric(5, 2);  -- ERROR: numeric field overflow

Zugehörige Fehler

Weitere Fehler bei Daten-Exceptions

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.