// PostgreSQL-Fehlerreferenz

PostgreSQL P0001: Ausnahme auslösen

Ein PL/pgSQL RAISE EXCEPTION ohne eigenen SQLSTATE. Die Nachricht ist der Text, den der Funktions- oder Triggerautor geschrieben hat.

SQLSTATE
P0001
Name
raise_exception
Kategorie
PL/pgSQL-Fehler
Fehlermeldung
insufficient funds for account 42

Was es bedeutet

P0001 (raise_exception) ist der Standardcode für RAISE EXCEPTION 'message' in PL/pgSQL. Streng genommen ist das kein PostgreSQL-Fehler: Eine Funktion, Prozedur oder ein Trigger in deiner Datenbank hat beschlossen zu scheitern, und der Meldungstext kommt aus dem zugehörigen Code. Die CONTEXT Zeilen zeigen, welche Funktion und welche Zeile ihn ausgelöst haben.

Funktionsautoren können einen spezifischen SQLSTATE mit USING ERRCODE, plus DETAIL und HINT, was den Fehler für Anwendungen leichter handhabbar macht.

Häufige Ursachen

  • Eine Geschäftsregel in einem Trigger oder einer Funktion, etwa eine Saldenprüfung, hat die Änderung zurückgewiesen.
  • Eine vom Programm aufgerufene Validierungsfunktion löste einen Fehler bei fehlerhaften Eingaben aus.
  • Eine ASSERT -Fehler meldet einen anderen Code, P0004 (assert_failure).

Wie du es behebst

  1. Lies die CONTEXT Zeilen, um Funktion und Zeile zu finden, und sieh dir dann den Quellcode an.

    SELECT pg_get_functiondef('debit_account'::regproc);
  2. Korrigiere die Daten oder den Aufruf, damit die Regel erfüllt wird, oder ändere die Regel, wenn sie falsch ist.

  3. Wenn du solche Prüfungen schreibst, gib ihnen einen aussagekräftigen Code und Detailtext, damit Aufrufer sie unterscheiden können.

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

Sicher reproduzieren

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

Zugehörige Fehler

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.