// Référence des erreurs SQLite

SQLITE_BUSY_SNAPSHOT : une lecture obsolète ne peut pas devenir une écriture

En mode WAL, une transaction qui a commencé par une lecture a tenté d'écrire après qu'une autre connexion ait déjà modifié la base de données. Attendre ne servira à rien ; redémarrez la transaction.

Code de résultat
SQLITE_BUSY_SNAPSHOT
Nom
517
Catégorie
Codes de résultat étendus
Message d'erreur
database is locked

Ce que cela signifie

SQLITE_BUSY_SNAPSHOT (517) se produit uniquement sur les bases de données en mode WAL. Une transaction de lecture voit un instantané de la base de données. Si elle essaie ensuite d’écrire, SQLite doit la mettre à niveau vers une transaction d’écriture, mais si une autre connexion a validé des modifications après la prise de l’instantané, les lectures précédentes ne sont plus à jour et la mise à niveau est refusée.

Contrairement à un simple SQLITE_BUSY, un délai d'occupation ne règle pas ce problème : la transaction doit être annulée puis relancée depuis le début.

Causes courantes

  • BEGIN (différée) suivie de SELECT puis de UPDATE, tandis qu’un autre processus valide entre-temps.
  • Transactions de lecture longues dans une application qui décide ensuite d’écrire.

Comment le corriger

  1. Démarrez des transactions qui vont écrire avec BEGIN IMMEDIATE, donc le verrou d'écriture est pris avant toute lecture.

    BEGIN IMMEDIATE;
    SELECT balance FROM accounts WHERE id = 1;
    UPDATE accounts SET balance = balance - 10 WHERE id = 1;
    COMMIT;
  2. Lorsque cela se produit, annulez puis réessayez l'ensemble de la transaction.

    ROLLBACK;

Erreurs liées

Plus de codes d'erreurs de résultat étendus

Le code et le texte du message sont issus de documentation des codes de résultat et d'erreur SQLite. Parcourir la liste complète Liste des erreurs SQLite ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur SQLite dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour SQLite et les autres bases de données que vous utilisez.