// PostgreSQL 錯誤參考
PostgreSQL 57014:取消陳述式
查詢已取消,可能是執行時間超過 statement_timeout,也可能是用戶端或管理員送出了取消請求。
- SQLSTATE
57014- 名稱
query_canceled- 類別
- 操作員介入
它的意義
57014 表示正在執行的陳述式在完成前被取消。訊息會說明原因: canceling statement due to statement timeout 當它執行時間超過 statement_timeout,而且 canceling statement due to user request 當用戶端按下取消(在 psql 中按 Ctrl+C,驅動程式的取消呼叫)或有人執行時 pg_cancel_backend() 在上面。
只有該語句會被取消;工作階段仍保持連線。在交易區塊內,交易此時已失敗,必須回復。
常見原因
- A
statement_timeout設定在伺服器、資料庫、角色或工作階段上,而查詢超過了它。 - 你或你的工具取消了查詢。
- 管理員或監控工作用
pg_cancel_backend(pid). - 慢速查詢:缺少索引、執行計畫不佳,或等待鎖定直到逾時。
如何修正
-
檢查適用的是哪個逾時設定,以及它是在哪裡設定的。
SHOW statement_timeout; SELECT name, setting, source FROM pg_settings WHERE name = 'statement_timeout';
-
只為確實需要更長時間的單一工作階段或交易調高,而不是全域調高。
SET statement_timeout = '10min'; -- or only for this transaction: BEGIN; SET LOCAL statement_timeout = '10min'; -- long-running work COMMIT;
-
讓查詢更快:檢視其執行計畫中是否對大型資料表進行循序掃描,並新增所需的索引。
EXPLAIN (ANALYZE, BUFFERS) SELECT * FROM orders WHERE customer_id = 42;
-
如果它在等待鎖定,請找出封鎖的來源。
SELECT pid, pg_blocking_pids(pid) AS blocked_by, wait_event_type, query FROM pg_stat_activity WHERE cardinality(pg_blocking_pids(pid)) > 0;
安全地重現問題
SET statement_timeout = '1s'; SELECT pg_sleep(5); -- ERROR: canceling statement due to statement timeout RESET statement_timeout;
相關錯誤
更多操作員介入錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。