// справочник ошибок 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 когда клиент нажал отмену (Ctrl+C в psql, вызов отмены через драйвер) или кто-то выполнил 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 или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.