// Référence des erreurs SQLite

SQLITE_PROTOCOL : protocole de verrouillage

En mode WAL, une connexion a perdu la course pour démarrer une transaction de nombreuses fois en quelques secondes et a abandonné. Très rare ; un signe d'une forte contention d'écriture.

Code de résultat
SQLITE_PROTOCOL
Nom
15
Catégorie
Codes de résultat principaux
Message d'erreur
locking protocol

Ce que cela signifie

La documentation SQLite décrit SQLITE_PROTOCOL (15) comme un problème de protocole de verrouillage de fichier, actuellement renvoyé uniquement en mode WAL au démarrage d'une transaction. Quand deux connexions se disputent le démarrage d'une transaction, la perdante se retire et réessaie ; si la même connexion perd encore au bout de plusieurs secondes, elle renvoie SQLITE_PROTOCOL. Cela ne devrait apparaître qu'avec de nombreux processus qui se disputent intensément l'écriture dans la même base de données.

Causes courantes

  • Beaucoup de processus écrivant la même base de données en mode WAL en même temps.
  • Verrouillage de fichier qui se comporte mal, par exemple sur un système de fichiers en réseau.

Comment le corriger

  1. Réduisez le nombre d'écrivains simultanés, par exemple en canalisant les écritures vers un seul processus ou une file d'attente.

  2. Gardez la base de données sur un disque local avec des verrous fonctionnels.

  3. Traitez-le comme SQLITE_BUSY: réessayez la transaction après une courte pause.

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.