// PostgreSQL 錯誤參考
PostgreSQL P0001:引發例外
PL/pgSQL 的 RAISE EXCEPTION 沒有自訂 SQLSTATE。訊息就是函式或觸發程序作者寫下的那段文字。
- SQLSTATE
P0001- 名稱
raise_exception
它的意義
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 和你使用的其他資料庫。