// PostgreSQL エラーリファレンス

PostgreSQL P0001: 例外の発生

独自の SQLSTATE を持たない PL/pgSQL の RAISE EXCEPTION。メッセージは、関数またはトリガーの作者が書いたテキストそのままです。

SQLSTATE
P0001
名前
raise_exception
カテゴリ
PL/pgSQL エラー
エラーメッセージ
insufficient funds for account 42

意味

P0001 (raise_exception)は次のデフォルトコードです RAISE EXCEPTION 'message' PL/pgSQL 内で発生します。これは PostgreSQL 本体のエラーではなく、データベース内の関数、プロシージャ、トリガーが意図的に投げたもので、メッセージ本文はそのコードに由来します。 CONTEXT 行は、どの関数のどの行がそれを発生させたかを示します。

関数の作成者は、次を使って特定の SQLSTATE を指定できます USING ERRCODE、さらに DETAIL そして HINT、これにより、アプリケーション側でエラーを処理しやすくなります。

よくある原因

  • トリガーや関数で実装されたビジネスルール(残高チェックなど)が、この変更を拒否しました。
  • アプリケーションが呼び出した検証関数が、不正な入力に対してエラーを発生させました。
  • ある ASSERT 失敗時には別のコードP0004(assert_failure).

修正方法

  1. 次をお読みください CONTEXT 行をたどって関数と行を特定し、そのソースを確認します。

    SELECT pg_get_functiondef('debit_account'::regproc);
  2. データまたは呼び出しを修正してルールを満たすようにするか、ルールが間違っている場合はルールを変更します。

  3. このようなチェックを書くときは、呼び出し元が区別できるよう、意味のあるコードと詳細を付けてください。

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

安全に再現する

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

関連エラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。