// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。