// PostgreSQL 錯誤參考

PostgreSQL 57014:取消陳述式

查詢已取消,可能是執行時間超過 statement_timeout,也可能是用戶端或管理員送出了取消請求。

SQLSTATE
57014
名稱
query_canceled
類別
操作員介入
錯誤訊息
canceling statement due to statement timeout

它的意義

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).
  • 慢速查詢:缺少索引、執行計畫不佳,或等待鎖定直到逾時。

如何修正

  1. 檢查適用的是哪個逾時設定,以及它是在哪裡設定的。

    SHOW statement_timeout;
    SELECT name, setting, source FROM pg_settings WHERE name = 'statement_timeout';
  2. 只為確實需要更長時間的單一工作階段或交易調高,而不是全域調高。

    SET statement_timeout = '10min';
    -- or only for this transaction:
    BEGIN;
    SET LOCAL statement_timeout = '10min';
    -- long-running work
    COMMIT;
  3. 讓查詢更快:檢視其執行計畫中是否對大型資料表進行循序掃描,並新增所需的索引。

    EXPLAIN (ANALYZE, BUFFERS) SELECT * FROM orders WHERE customer_id = 42;
  4. 如果它在等待鎖定,請找出封鎖的來源。

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