// Référence des erreurs PostgreSQL

PostgreSQL 57014 : annulation de l'instruction

La requête a été annulée, soit parce qu'elle a dépassé statement_timeout, soit parce qu'un client ou un administrateur a envoyé une demande d'annulation.

SQLSTATE
57014
Nom
query_canceled
Catégorie
Intervention de l'opérateur
Message d'erreur
canceling statement due to statement timeout

Ce que cela signifie

57014 signifie que la requête en cours a été annulée avant qu'elle ne se termine. Le message indique pourquoi : canceling statement due to statement timeout lorsqu'elle a duré plus longtemps que statement_timeout, et canceling statement due to user request lorsqu'un client appuyait sur Annuler (Ctrl+C dans psql, un appel d'annulation du pilote) ou que quelqu'un exécutait pg_cancel_backend() dessus.

Seule l'instruction est annulée ; la session reste connectée. À l'intérieur d'un bloc de transaction, la transaction est désormais en échec et doit être annulée (rollback).

Causes courantes

  • A statement_timeout défini sur le serveur, la base de données, le rôle ou la session et que la requête a dépassé.
  • Vous ou votre outil avez annulé la requête.
  • Un administrateur ou un travail de surveillance l'a annulée avec pg_cancel_backend(pid).
  • Une requête lente: un index manquant, un mauvais plan, ou une attente de verrou qui a duré jusqu'au délai d'expiration.

Comment le corriger

  1. Vérifiez quel délai d'attente s'applique et où il a été défini.

    SHOW statement_timeout;
    SELECT name, setting, source FROM pg_settings WHERE name = 'statement_timeout';
  2. Augmentez-le pour la seule session ou transaction qui nécessite réellement plus de temps, plutôt que globalement.

    SET statement_timeout = '10min';
    -- or only for this transaction:
    BEGIN;
    SET LOCAL statement_timeout = '10min';
    -- long-running work
    COMMIT;
  3. Rendez la requête plus rapide : examinez son plan pour repérer les parcours séquentiels sur de grandes tables, puis ajoutez l'index dont elle a besoin.

    EXPLAIN (ANALYZE, BUFFERS) SELECT * FROM orders WHERE customer_id = 42;
  4. S'il attendait un verrou, trouvez le bloqueur.

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

Reproduisez-le en toute sécurité

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

Erreurs liées

Plus d'erreurs d'intervention par l'opérateur

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.