// SQLite-Fehlerreferenz

SQLITE_TOOBIG: Zeichenfolge oder BLOB zu groß

Ein String, ein BLOB oder eine SQL-Anweisung war größer als das Limit von SQLite, standardmäßig 1.000.000.000 Byte, oder ein niedrigeres, von der Anwendung gesetztes Limit.

Ergebniscode
SQLITE_TOOBIG
Name
18
Kategorie
Primäre Ergebniscodes
Fehlermeldung
string or blob too big

Was es bedeutet

SQLITE_TOOBIG (18) wird zurückgegeben, wenn eine Zeichenfolge oder ein BLOB die maximale Länge überschreitet, die zur Kompilierzeit mit SQLITE_MAX_LENGTH festgelegt wurde (Standard 1.000.000.000 Bytes) oder zur Laufzeit mit sqlite3_limit(db, SQLITE_LIMIT_LENGTH, ...). Eine übergroße SQL-Anweisung bekommt denselben Fehler; ihr Limit ist SQLITE_MAX_SQL_LENGTH / SQLITE_LIMIT_SQL_LENGTH. Eine Zeile, die größer als das Längenlimit ist, schlägt ebenfalls fehl.

Häufige Ursachen

  • Speichern einer sehr großen Datei oder eines Dokuments in einem einzigen BLOB- oder TEXT-Wert.
  • Eine riesige SQL-Anweisung erstellen, etwa ein mehrzeiliges INSERT mit Millionen von Literalwerten.
  • Eine Anwendung oder Bindung, die die Grenze mit sqlite3_limit().
  • A group_concat() gesenkt hat, oder Zeichenfolgenkonkatenation, die über das Limit hinauswächst.

Wie du es behebst

  1. Speichere große Dateien außerhalb der Datenbank und behalte ihre Pfade, oder teile den Inhalt in Chunks über mehrere Zeilen auf.

  2. Füge viele Zeilen mit einer vorbereiteten Anweisung ein, die wiederholt mit gebundenen Parametern ausgeführt wird, statt einer einzigen riesigen Anweisung.

    INSERT INTO items (id, name) VALUES (?, ?);  -- prepare once, bind and run per row
  3. Prüfe, ob deine Bindung ein unteres Längenlimit setzt, und erhöhe es gegebenenfalls.

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.