// Referencia de errores de SQLite

SQLITE_BUSY_SNAPSHOT: Una lectura obsoleta no puede convertirse en escritura

En modo WAL, una transacción que empezó como lectura intentó escribir después de que otra conexión ya había modificado la base de datos. Esperar no ayuda; reinicia la transacción.

Código de resultado
SQLITE_BUSY_SNAPSHOT
Nombre
517
Categoría
Códigos de resultado extendidos
Mensaje de error
database is locked

Qué significa

SQLITE_BUSY_SNAPSHOT (517) sucede solo en bases de datos en modo WAL. Una transacción de lectura ve una instantánea de la base de datos. Si luego intenta escribir, SQLite debe promoverla a transacción de escritura, pero si otra conexión confirmó cambios después de que se tomara la instantánea, las lecturas anteriores quedan desfasadas y la promoción se rechaza.

A diferencia de plain SQLITE_BUSY, un busy timeout no arregla esto: hay que revertir la transacción y ejecutarla de nuevo desde el principio.

Causas comunes

  • BEGIN (deferred) seguido de SELECT y luego UPDATE, mientras otro proceso confirma cambios entre medias.
  • Transacciones largas de lectura en una aplicación que luego decide escribir.

Cómo solucionarlo

  1. Inicia las transacciones que van a escribir con BEGIN IMMEDIATE, así que el bloqueo de escritura se toma antes de cualquier lectura.

    BEGIN IMMEDIATE;
    SELECT balance FROM accounts WHERE id = 1;
    UPDATE accounts SET balance = balance - 10 WHERE id = 1;
    COMMIT;
  2. Cuando suceda, revierte y reintenta toda la transacción.

    ROLLBACK;

Errores relacionados

Más errores de códigos de resultado extendidos

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.