// PostgreSQL-Fehlerreferenz

PostgreSQL 57014: Anweisung wird abgebrochen

Die Abfrage wurde abgebrochen, entweder weil sie über statement_timeout hinauslief oder weil ein Client oder Administrator eine Abbruchanfrage geschickt hat.

SQLSTATE
57014
Name
query_canceled
Kategorie
Eingreifen des Bedieners
Fehlermeldung
canceling statement due to statement timeout

Was es bedeutet

57014 bedeutet, dass die laufende Anweisung abgebrochen wurde, bevor sie abgeschlossen war. Die Meldung erklärt den Grund: canceling statement due to statement timeout wenn sie länger lief als statement_timeout, und canceling statement due to user request wenn ein Client Abbrechen gedrückt hat (Strg+C in psql, ein Abbruchaufruf des Treibers) oder jemand ausführte pg_cancel_backend() daran.

Es wird nur die Anweisung abgebrochen; die Sitzung bleibt verbunden. Innerhalb eines Transaktionsblocks ist die Transaktion jetzt fehlgeschlagen und muss zurückgesetzt werden.

Häufige Ursachen

  • A statement_timeout auf dem Server, der Datenbank, der Rolle oder der Sitzung festgelegt, die die Abfrage überschritten hat.
  • Du oder dein Werkzeug haben die Abfrage abgebrochen.
  • Ein Administrator oder ein Überwachungsjob hat es mit abgebrochen pg_cancel_backend(pid).
  • Eine langsame Abfrage: ein fehlender Index, ein schlechter Plan oder das Warten auf eine Sperre, bis das Timeout ausgelöst wurde.

Wie du es behebst

  1. Prüfe, welcher Timeout gilt und wo er gesetzt wurde.

    SHOW statement_timeout;
    SELECT name, setting, source FROM pg_settings WHERE name = 'statement_timeout';
  2. Erhöhe es für die eine Sitzung oder Transaktion, die es zu Recht länger braucht, statt global.

    SET statement_timeout = '10min';
    -- or only for this transaction:
    BEGIN;
    SET LOCAL statement_timeout = '10min';
    -- long-running work
    COMMIT;
  3. Mach die Abfrage schneller: sieh dir im Plan die sequenziellen Scans auf großen Tabellen an und ergänze den Index, der fehlt.

    EXPLAIN (ANALYZE, BUFFERS) SELECT * FROM orders WHERE customer_id = 42;
  4. Wenn sie auf eine Sperre gewartet hat, finde die blockierende Sitzung.

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

Sicher reproduzieren

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

Zugehörige Fehler

Weitere Fehler bei Operatoreingriffen

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.