// SQLite-Fehlerreferenz

SQLITE_INTERRUPT: Unterbrochen

Eine laufende Anweisung wurde von sqlite3_interrupt() gestoppt, normalerweise weil der Benutzer oder die Anwendung sie abgebrochen hat.

Ergebniscode
SQLITE_INTERRUPT
Name
9
Kategorie
Primäre Ergebniscodes
Fehlermeldung
interrupted

Was es bedeutet

SQLITE_INTERRUPT (9) ist das, was eine Anweisung zurückgibt, nachdem sqlite3_interrupt() auf ihrer Verbindung aufgerufen wurde. Anwendungen rufen es auf, um lange Abfragen abzubrechen, oft von einem anderen Thread aus, wenn der Benutzer Abbrechen drückt oder ein Timeout eintritt. Wenn die unterbrochene Anweisung ein Schreibvorgang innerhalb einer expliziten Transaktion war, kann die Transaktion automatisch zurückgesetzt worden sein.

Häufige Ursachen

  • Der Benutzer hat die Abfrage in der Anwendung abgebrochen.
  • Das eigene Timeout der Anwendung: Aufruf von sqlite3_interrupt().
  • Ein Fortschritts-Handler, der einen Nicht-Null-Wert zurückgibt, was ebenfalls die Anweisung unterbricht.

Wie du es behebst

  1. Wenn du absichtlich abgebrochen hast, ist alles gut. Prüfe vor dem Weitermachen, ob noch eine offene Transaktion aktiv ist, und mach ein Rollback, wenn du unsicher bist.

    ROLLBACK;
  2. Wenn ein Timeout eine Abfrage abgebrochen hat, die eigentlich fertig werden sollte, mach sie schneller: Prüfe den Plan und ergänze einen Index für den Filter oder Join.

    EXPLAIN QUERY PLAN SELECT * FROM orders WHERE customer_id = 42;
    CREATE INDEX idx_orders_customer ON orders(customer_id);

Zugehörige Fehler

Weitere Fehler bei primären Ergebniscodes

Der Code und der Meldungstext stammen aus der SQLite-Dokumentation zu Ergebnis- und Fehlercodes. Durchstöbere die vollständige SQLite-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit SQLite 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 SQLite und die anderen Datenbanken, mit denen du arbeitest.