// Referência de erro do PostgreSQL

PostgreSQL 57014: cancelando instrução

A consulta foi cancelada, seja porque ultrapassou o statement_timeout ou porque um cliente ou administrador enviou uma solicitação de cancelamento.

SQLSTATE
57014
Nome
query_canceled
Categoria
Intervenção do operador
Mensagem de erro
canceling statement due to statement timeout

O que significa

57014 significa que a instrução em execução foi cancelada antes de terminar. A mensagem indica o motivo: canceling statement due to statement timeout quando ela durou mais do que statement_timeout, e canceling statement due to user request quando um cliente pressionou cancelar (Ctrl+C no psql, uma chamada de cancelamento do driver) ou alguém executou pg_cancel_backend() nisso.

Apenas a instrução é cancelada; a sessão permanece conectada. Dentro de um bloco de transação, a transação fica em estado de falha e deve ser revertida.

Causas comuns

  • A statement_timeout definido no servidor, banco de dados, função ou sessão que a consulta excedeu.
  • Você ou sua ferramenta cancelaram a consulta.
  • Um administrador ou um trabalho de monitoramento o cancelou com pg_cancel_backend(pid).
  • Uma consulta lenta: um índice ausente, um plano ruim ou uma espera por bloqueio até o tempo limite estourar.

Como corrigir

  1. Verifique qual timeout se aplica e onde foi definido.

    SHOW statement_timeout;
    SELECT name, setting, source FROM pg_settings WHERE name = 'statement_timeout';
  2. Aumente isso para a única sessão ou transação que realmente precisa de mais tempo, em vez de globalmente.

    SET statement_timeout = '10min';
    -- or only for this transaction:
    BEGIN;
    SET LOCAL statement_timeout = '10min';
    -- long-running work
    COMMIT;
  3. Torne a consulta mais rápida: veja o plano dela em busca de varreduras sequenciais em tabelas grandes e adicione o índice de que ela precisa.

    EXPLAIN (ANALYZE, BUFFERS) SELECT * FROM orders WHERE customer_id = 42;
  4. Se estava esperando por um bloqueio, descubra quem estava bloqueando.

    SELECT pid, pg_blocking_pids(pid) AS blocked_by, wait_event_type, query
    FROM pg_stat_activity
    WHERE cardinality(pg_blocking_pids(pid)) > 0;

Reproduza com segurança

SET statement_timeout = '1s';
SELECT pg_sleep(5);  -- ERROR: canceling statement due to statement timeout
RESET statement_timeout;

Erros relacionados

Mais erros de intervenção do operador

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.