// Référence des erreurs PostgreSQL

PostgreSQL 22023 : valeur de paramètre invalide

Un paramètre de configuration ou un argument de fonction a une valeur en dehors de celle qu'il accepte : un fuseau horaire inconnu, une unité incorrecte dans un paramètre de mémoire, un pas nul dans generate_series.

SQLSTATE
22023
Nom
invalid_parameter_value
Catégorie
Exception de données
Message d'erreur
invalid value for parameter "TimeZone": "Mars/Olympus"

Ce que cela signifie

22023 (invalid_parameter_value) signifie que la valeur est du bon type mais pas une valeur autorisée. Pour les paramètres de configuration, le message est invalid value for parameter "name": "value", souvent avec un indice listant les unités ou valeurs valides. De nombreuses fonctions intégrées utilisent le même code pour les arguments incorrects, comme step size cannot equal zero de generate_series.

Lisez attentivement le message et l'indice : ils nomment le paramètre et, généralement, ce qui est autorisé.

Causes courantes

  • Un nom de fuseau horaire que PostgreSQL ne connaît pas (les noms valides se trouvent dans pg_timezone_names).
  • Un paramètre de mémoire ou de temps avec une unité incorrecte, comme work_mem = '64mb' au lieu de '64MB' (les unités sont sensibles à la casse).
  • Un argument de fonction en dehors de sa plage ou de son ensemble autorisé, comme un pas nul ou un mot-clé d'option inconnu.

Comment le corriger

  1. Vérifiez les valeurs valides pour un paramètre.

    SELECT name, unit, vartype, min_val, max_val, enumvals
    FROM pg_settings WHERE name = 'work_mem';
  2. Choisissez un fuseau horaire dans la liste que PostgreSQL connaît.

    SELECT name FROM pg_timezone_names WHERE name ILIKE '%new_york%';
    SET TimeZone = 'America/New_York';
  3. Utilisez les unités telles que PostgreSQL les écrit : kB, MB, GB, TB pour la mémoire et us, ms, s, min, h, d pour le temps.

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

Reproduisez-le en toute sécurité

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

Erreurs liées

Plus d'erreurs d'exception de données

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.