// Referencia de errores de SQLite

SQLITE_NOTADB: El archivo no es una base de datos

El archivo abierto no parece una base de datos SQLite: es otro tipo de archivo, está cifrado o su encabezado está dañado.

Código de resultado
SQLITE_NOTADB
Nombre
26
Categoría
Códigos de resultado primarios
Mensaje de error
file is not a database

Qué significa

SQLITE_NOTADB (26) significa que la cabecera del archivo no coincide con el formato de SQLite. Toda base de datos SQLite empieza con los 16 bytes SQLite format 3 seguido de un byte cero. Abrir un archivo solo lo lee de forma diferida, así que el error suele aparecer en la primera consulta y no al abrirlo.

Causas comunes

  • La ruta apunta a un tipo de archivo diferente, como un CSV, un volcado SQL o una base de datos de otro motor.
  • La base de datos está cifrada (SQLCipher u otra extensión de cifrado) y se abrió sin la clave, o con una biblioteca que no admite cifrado.
  • La parte inicial del archivo resultó dañada, por ejemplo por una descarga o una copia interrumpida.
  • Se proporcionó un volcado de texto SQL cuando se esperaba un archivo de base de datos; cárgalo con la consola en su lugar.

Cómo solucionarlo

  1. Verifica los primeros bytes del archivo. En macOS o Linux: head -c 16 app.db debería imprimir SQLite format 3.

  2. Si la base de datos está cifrada, ábrela con la biblioteca y la clave correspondientes.

  3. Si el archivo es un volcado SQL, crea una base de datos a partir de él: sqlite3 new.db < dump.sql.

  4. Si el encabezado está dañado, prueba el comando .recover o restaura una copia de seguridad.

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.