// PostgreSQL 錯誤參考

PostgreSQL P0001:引發例外

PL/pgSQL 的 RAISE EXCEPTION 沒有自訂 SQLSTATE。訊息就是函式或觸發程序作者寫下的那段文字。

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 和你使用的其他資料庫。