// Référence des erreurs SQLite

SQLITE_LOCKED : la table de la base de données est verrouillée

Une écriture n'a pas pu continuer à cause d'un conflit à l'intérieur de la même connexion ou du cache partagé, comme la suppression d'une table qu'une instruction est encore en train de lire.

Code de résultat
SQLITE_LOCKED
Nom
6
Catégorie
Codes de résultat principaux
Message d'erreur
database table is locked

Ce que cela signifie

SQLITE_LOCKED (6) signifie que le conflit se produit au sein de votre propre connexion, ou entre des connexions partageant un cache, et non avec un autre processus. L'exemple classique tiré de la documentation SQLite est un DROP TABLE pendant qu'une autre instruction sur la même connexion est encore en train de lire cette table : la supprimer retirerait la table sous les pieds de l'instruction qui la lit.

C'est différent de SQLITE_BUSY, ce qui signifie qu'une autre connexion, généralement dans un autre processus, détient un verrou. Attendre ne résout pas SQLITE_LOCKED; terminer l'autre instruction le fait.

Causes courantes

  • Exécution DROP TABLE, ALTER TABLE ou similaire pendant qu'une SELECT sur la même connexion n'a pas été avancée jusqu'à la fin ou réinitialisée.
  • Écriture dans une table tout en itérant une requête sur celle-ci avec une instruction non terminée, dans certains cas.
  • Mode de cache partagé, où une connexion modifiant une table bloque les autres partageant le cache (SQLITE_LOCKED_SHAREDCACHE).

Comment le corriger

  1. Terminez, réinitialisez ou finalisez chaque instruction avant de changer le schéma. En Python, récupérez toutes les lignes ou fermez d'abord le curseur.

  2. Lisez d'abord les lignes dont vous avez besoin en mémoire, puis exécutez le DDL ou les écritures.

    -- read first
    SELECT id FROM staging;
    -- then, after the reader is done:
    DROP TABLE staging;
  3. Évitez le mode de cache partagé sauf si vous en avez besoin. SQLite le déconseille ; le mode WAL est le moyen habituel d'obtenir des lecteurs concurrents.

Questions

Un busy timeout résoudra-t-il SQLITE_LOCKED ?

Non. Le busy handler sert à gérer les conflits avec d'autres connexions (SQLITE_BUSY). SQLITE_LOCKED est un conflit au sein de votre propre connexion ou du cache partagé ; pour le résoudre, terminez ou réinitialisez l'instruction qui bloque.

Erreurs liées

Plus d'erreurs de codes de résultat principaux

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.