// PostgreSQL-Fehlerreferenz

PostgreSQL 22023: ungültiger Parameterwert

Eine Einstellung oder ein Funktionsargument hat einen Wert außerhalb des zulässigen Bereichs: eine unbekannte Zeitzone, eine falsche Einheit in einer Speichereinstellung, die Schrittweite null in generate_series.

SQLSTATE
22023
Name
invalid_parameter_value
Kategorie
Daten-Ausnahme
Fehlermeldung
invalid value for parameter "TimeZone": "Mars/Olympus"

Was es bedeutet

22023 (invalid_parameter_value) bedeutet, dass der Wert zwar den richtigen Typ, aber keinen erlaubten Wert hat. Für Konfigurationsparameter lautet die Meldung invalid value for parameter "name": "value", oft mit einem Hinweis, der die gültigen Einheiten oder Werte auflistet. Viele eingebaute Funktionen verwenden denselben Code für ungültige Argumente, wie zum Beispiel step size cannot equal zero von generate_series.

Lies Meldung und Hinweis genau: Sie nennen den Parameter und meist, was erlaubt ist.

Häufige Ursachen

  • Ein Zeitzonenname, den PostgreSQL nicht kennt (die gültigen Namen befinden sich in pg_timezone_names).
  • Eine Speicher- oder Zeiteinstellung mit einer falschen Einheit, wie zum Beispiel work_mem = '64mb' statt '64MB' (bei den Einheiten wird zwischen Groß- und Kleinschreibung unterschieden).
  • Ein Funktionsargument außerhalb seines erlaubten Bereichs oder seiner erlaubten Menge, wie eine Schrittweite von null oder ein unbekanntes Optionsschlüsselwort.

Wie du es behebst

  1. Prüfe die gültigen Werte für eine Einstellung.

    SELECT name, unit, vartype, min_val, max_val, enumvals
    FROM pg_settings WHERE name = 'work_mem';
  2. Wähle eine Zeitzone aus der Liste, die PostgreSQL kennt.

    SELECT name FROM pg_timezone_names WHERE name ILIKE '%new_york%';
    SET TimeZone = 'America/New_York';
  3. Verwende die Einheiten so, wie PostgreSQL sie schreibt: kB, MB, GB, TB für den Speicher und us, ms, s, min, h, d für die Zeit.

    SET work_mem = '64MB';
    SET statement_timeout = '30s';

Sicher reproduzieren

SET TimeZone = 'Mars/Olympus';  -- ERROR: invalid value for parameter "TimeZone": "Mars/Olympus"

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.