PostgreSQL P0001: 例外の発生
独自の SQLSTATE を持たない PL/pgSQL の RAISE EXCEPTION。メッセージは、関数またはトリガーの作者が書いたテキストそのままです。
- SQLSTATE
P0001- 名前
raise_exception- カテゴリ
- PL/pgSQL エラー
意味
P0001 (raise_exception)は次のデフォルトコードです RAISE EXCEPTION 'message' PL/pgSQL 内で発生します。これは PostgreSQL 本体のエラーではなく、データベース内の関数、プロシージャ、トリガーが意図的に投げたもので、メッセージ本文はそのコードに由来します。 CONTEXT 行は、どの関数のどの行がそれを発生させたかを示します。
関数の作成者は、次を使って特定の SQLSTATE を指定できます USING ERRCODE、さらに DETAIL そして HINT、これにより、アプリケーション側でエラーを処理しやすくなります。
よくある原因
- トリガーや関数で実装されたビジネスルール(残高チェックなど)が、この変更を拒否しました。
- アプリケーションが呼び出した検証関数が、不正な入力に対してエラーを発生させました。
- ある
ASSERT失敗時には別のコードP0004(assert_failure).
修正方法
-
次をお読みください
CONTEXT行をたどって関数と行を特定し、そのソースを確認します。SELECT pg_get_functiondef('debit_account'::regproc); -
データまたは呼び出しを修正してルールを満たすようにするか、ルールが間違っている場合はルールを変更します。
-
このようなチェックを書くときは、呼び出し元が区別できるよう、意味のあるコードと詳細を付けてください。
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 をはじめ、お使いの他のデータベースにも対応します。