// Referencia de errores de PostgreSQL

PostgreSQL 57014: cancelando la instrucción

La consulta se canceló, ya sea porque superó statement_timeout o porque un cliente o un administrador envió una solicitud de cancelación.

SQLSTATE
57014
Nombre
query_canceled
Categoría
Intervención del operador
Mensaje de error
canceling statement due to statement timeout

Qué significa

57014 significa que la instrucción en ejecución se canceló antes de terminar. El mensaje indica el motivo: canceling statement due to statement timeout cuando duró más de statement_timeout, y canceling statement due to user request cuando un cliente presionó cancelar (Ctrl+C en psql, una llamada de cancelación de un controlador) o alguien ejecutó pg_cancel_backend() sobre ello.

Solo se cancela la instrucción; la sesión permanece conectada. Dentro de un bloque de transacción, la transacción ahora ha fallado y debe revertirse.

Causas comunes

  • A statement_timeout establecido en el servidor, base de datos, rol o sesión que la consulta excedió.
  • Tú o tu herramienta cancelaron la consulta.
  • Un administrador o un trabajo de monitoreo la canceló con pg_cancel_backend(pid).
  • Una consulta lenta: un índice que falta, un mal plan o esperar un bloqueo hasta que se agotó el tiempo de espera.

Cómo solucionarlo

  1. Verifica qué tiempo de espera aplica y dónde se estableció.

    SHOW statement_timeout;
    SELECT name, setting, source FROM pg_settings WHERE name = 'statement_timeout';
  2. Auméntalo solo para la sesión o transacción que de verdad necesite más tiempo, en lugar de hacerlo globalmente.

    SET statement_timeout = '10min';
    -- or only for this transaction:
    BEGIN;
    SET LOCAL statement_timeout = '10min';
    -- long-running work
    COMMIT;
  3. Haz que la consulta sea más rápida: revisa su plan en busca de escaneos secuenciales sobre tablas grandes y añade el índice que le falta.

    EXPLAIN (ANALYZE, BUFFERS) SELECT * FROM orders WHERE customer_id = 42;
  4. Si estaba esperando un bloqueo, averigua quién lo bloquea.

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

Reprodúcelo de forma segura

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

Errores relacionados

Más errores de intervención del operador

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.