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
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, sodassnextvaleinen 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 einemnumeric(5,2)Spalte hinzu. - Umwandeln eines großen Text- oder Gleitkommawerts in
integerodersmallint.
Wie du es behebst
-
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;
-
Vor der Arithmetik zu einem breiteren Typ konvertieren, nicht danach.
SELECT qty::bigint * unit_price_cents FROM order_lines;
-
Die Genauigkeit einer
numeric(p, s)Spalte hinzu.ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
-
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
22001Wert zu lang für den Typ22P02Ungültige Eingabesyntax für den Typ22012Division durch null8115SQL Server: Arithmetischer Überlauffehler bei der Konvertierung1264MySQL: Wert für Spalte außerhalb des zulässigen BereichsORA-01438Oracle: Wert größer als die angegebene Genauigkeit
Weitere Fehler bei Daten-Exceptions
22021Ungültige Byte-Sequenz für die Kodierung22008Datum-/Uhrzeitfeldwert außerhalb des zulässigen Bereichs22007Ungültiges Datums-/Uhrzeitformat22023Ungültiger Parameterwert
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.
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.