// Référence des erreurs PostgreSQL

PostgreSQL P0001 : exception levée

Une instruction PL/pgSQL RAISE EXCEPTION sans SQLSTATE propre. Le message est le texte que l'auteur de la fonction ou du déclencheur a écrit.

SQLSTATE
P0001
Nom
raise_exception
Catégorie
Erreur PL/pgSQL
Message d'erreur
insufficient funds for account 42

Ce que cela signifie

P0001 (raise_exception) est le code par défaut pour RAISE EXCEPTION 'message' en PL/pgSQL. Ce n'est pas une erreur PostgreSQL en soi : une fonction, procédure ou déclencheur dans votre base de données a choisi d'échouer, et le texte du message provient de son code. Les CONTEXT lignes montrent quelle fonction et quelle ligne l'ont déclenché.

Les auteurs de fonctions peuvent attribuer un SQLSTATE spécifique avec USING ERRCODE, ainsi que DETAIL et HINT, ce qui rend l'erreur plus facile à gérer pour les applications.

Causes courantes

  • Une règle métier appliquée dans un déclencheur ou une fonction, comme un contrôle de solde, a rejeté la modification.
  • Une fonction de validation appelée par l'application a généré une erreur en raison d'une saisie incorrecte.
  • Une ASSERT signale un code différent, P0004 (assert_failure).

Comment le corriger

  1. Lisez les CONTEXT lignes pour trouver la fonction et la ligne, puis examinez son code source.

    SELECT pg_get_functiondef('debit_account'::regproc);
  2. Corrigez les données ou l'appel afin que la règle soit respectée, ou changez la règle si elle est incorrecte.

  3. Lors de la rédaction de telles vérifications, donnez-leur un code significatif et un détail afin que les appelants puissent les distinguer.

    RAISE EXCEPTION 'insufficient funds for account %', p_account
        USING ERRCODE = 'check_violation',
              DETAIL = format('balance %s, requested %s', v_balance, p_amount);

Reproduisez-le en toute sécurité

DO $$ BEGIN RAISE EXCEPTION 'something went wrong'; END $$;  -- ERROR: something went wrong (SQLSTATE P0001)

Erreurs lié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.