// SQLite エラーリファレンス

SQLITE_BUSY: データベースがロックされています

別の接続が SQLite に必要なロックを保持しています。通常は別のプロセスのライターです。ビジータイムアウトを設定するか、書き込みトランザクションを短く保つか、WAL モードに切り替えてください。

結果コード
SQLITE_BUSY
名前
5
カテゴリ
主な結果コード
エラーメッセージ
database is locked

意味

SQLite では、データベースファイルごとに同時に書き込めるのは 1 つの接続だけです。ある接続が、別の接続 (同じプロセスでも別のプロセスでも) が保持しているロックを必要とすると、呼び出しは次のエラーで失敗します SQLITE_BUSY とメッセージ database is locked、ビジーハンドラーが設定されていない限りです。設定されている場合、SQLite はまずタイムアウトまで再試行します。

既定ではビジー ハンドラーがないため、失敗は即座に発生します。ロールバック ジャーナル モードでは、リーダーがライターのコミットもブロックし、ライターはコミット中に新しいリーダーをブロックします。WAL モードでは、リーダーと 1 つのライターが同時に動作できます。

よくある原因

  • 2 つのプロセスまたはスレッドが同じデータベースに同時に書き込み、busy タイムアウトが設定されていません。
  • 長い書き込みトランザクション(または BEGIN コミットされなかったもの)は、他のユーザーが待機している間ロックを保持し続けます。
  • 読み取りトランザクションを BEGIN DEFERRED 別の接続が書き込み中に書き込みへのアップグレードを試みます。WAL モードでは、これは次を返します SQLITE_BUSY_SNAPSHOT そして待っても解決しません。
  • 自分のプログラム内の、開いたままのカーソルまたは未完了のステートメントが、読み取りトランザクションを開いたままにしている。
  • データベースファイルは、ロックが確実に動作しないネットワークファイルシステムにあります。

修正方法

  1. ビジータイムアウトを設定すると、SQLite は即座に失敗せず、待機して再試行します。ほとんどのバインディングで設定できます(Pythonの sqlite3 デフォルトでは 5 秒待機します。引き上げるには sqlite3.connect(path, timeout=30))。SQL では:

    PRAGMA busy_timeout = 5000;  -- milliseconds
  2. データベースを先行書き込みログ(WAL)に切り替えるので、リーダーがライターをブロックせず、ライターもリーダーをブロックしなくなります。

    PRAGMA journal_mode = WAL;
  3. 書き込みトランザクションの開始に使うのは BEGIN IMMEDIATE、これは書き込みロックを先に取得します。ビジー状態の接続は、その後次で待機します BEGIN (タイムアウトが適用される箇所)で、途中で失敗するのではなく。

    BEGIN IMMEDIATE;
    UPDATE counters SET n = n + 1 WHERE name = 'visits';
    COMMIT;
  4. トランザクションを短く保ち、すぐにコミットし、すべてのステートメントを完了またはリセットして(カーソルを閉じる)、接続が必要以上に長くロックを保持しないようにします。

  5. データベースはネットワーク共有ではなく、ローカルディスクに置いてください。

安全に再現する

同じスクラッチデータベースファイルへの 2 つの別々の接続を使用します。

-- Connection 1 (for example the sqlite3 shell):
BEGIN IMMEDIATE;
INSERT INTO t VALUES (1);
-- Connection 2, same file, no busy timeout:
INSERT INTO t VALUES (2);   -- Runtime error: database is locked (5)

質問

SQLITE_BUSY と SQLITE_LOCKED の違いは何ですか?

SQLITE_BUSY 別のデータベース接続(通常は別のプロセス)が競合するロックを保持していることを意味します。 SQLITE_LOCKED 競合が自分自身の接続内、またはキャッシュを共有する接続間で起きていることを意味します。たとえば、ステートメントがまだテーブルを読み取っている間にそのテーブルを削除した場合です。

WAL モードで「database is locked」エラーはなくなりますか?

読み取りと書き込みの競合の大半を解消しますが、同時に書き込めるのは依然として 1 つだけなので、同時書き込みにはビジータイムアウトが必要です。

関連エラー

その他のプライマリ結果コードのエラー

コードとメッセージのテキストは、 SQLite の結果コードとエラーコードのドキュメント。全容は次で参照 SQLite エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で SQLite を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、SQLite をはじめ、お使いの他のデータベースにも対応します。