// Referencia de errores de SQLite

SQLITE_TOOBIG: Cadena o blob demasiado grande

Una cadena, BLOB o instrucción SQL era más grande que el límite de SQLite, 1.000.000.000 bytes por defecto, o un límite menor establecido por la aplicación.

Código de resultado
SQLITE_TOOBIG
Nombre
18
Categoría
Códigos de resultado primarios
Mensaje de error
string or blob too big

Qué significa

SQLITE_TOOBIG (18) se devuelve cuando una cadena o un BLOB supera la longitud máxima, establecida en tiempo de compilación con SQLITE_MAX_LENGTH (1.000.000.000 bytes por defecto) o reducida en tiempo de ejecución con sqlite3_limit(db, SQLITE_LIMIT_LENGTH, ...). Una instrucción SQL demasiado grande da el mismo error; su límite es SQLITE_MAX_SQL_LENGTH / SQLITE_LIMIT_SQL_LENGTH. Una fila que supere el límite de longitud también falla.

Causas comunes

  • Almacenar un archivo o documento muy grande en un solo valor BLOB o TEXT.
  • Construir una instrucción SQL enorme, como un INSERT de varias filas con millones de valores literales.
  • Una aplicación o un binding que bajó el límite con sqlite3_limit().
  • A group_concat() o concatenación de cadenas que supera el límite.

Cómo solucionarlo

  1. Guarda los archivos grandes fuera de la base de datos y conserva sus rutas, o reparte el contenido en fragmentos entre varias filas.

  2. Inserta muchas filas con una instrucción preparada ejecutada repetidamente, con parámetros vinculados, en lugar de una sola instrucción enorme.

    INSERT INTO items (id, name) VALUES (?, ?);  -- prepare once, bind and run per row
  3. Comprueba si tu binding impone un límite de longitud menor y, si conviene, súbelo.

Errores relacionados

Más errores de códigos de resultado principales

El código y el texto del mensaje son de Documentación de los códigos de resultado y de error de SQLite. Explora la lista completa de Lista de errores de SQLite o buscar cada error de base de datos.

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

Trabajar con SQLite 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 SQLite y las demás bases de datos que uses.