SQLITE_BUSY: データベースがロックされています
別の接続が SQLite に必要なロックを保持しています。通常は別のプロセスのライターです。ビジータイムアウトを設定するか、書き込みトランザクションを短く保つか、WAL モードに切り替えてください。
- 結果コード
SQLITE_BUSY- 名前
5- カテゴリ
- 主な結果コード
意味
SQLite では、データベースファイルごとに同時に書き込めるのは 1 つの接続だけです。ある接続が、別の接続 (同じプロセスでも別のプロセスでも) が保持しているロックを必要とすると、呼び出しは次のエラーで失敗します SQLITE_BUSY とメッセージ database is locked、ビジーハンドラーが設定されていない限りです。設定されている場合、SQLite はまずタイムアウトまで再試行します。
既定ではビジー ハンドラーがないため、失敗は即座に発生します。ロールバック ジャーナル モードでは、リーダーがライターのコミットもブロックし、ライターはコミット中に新しいリーダーをブロックします。WAL モードでは、リーダーと 1 つのライターが同時に動作できます。
よくある原因
- 2 つのプロセスまたはスレッドが同じデータベースに同時に書き込み、busy タイムアウトが設定されていません。
- 長い書き込みトランザクション(または
BEGINコミットされなかったもの)は、他のユーザーが待機している間ロックを保持し続けます。 - 読み取りトランザクションを
BEGIN DEFERRED別の接続が書き込み中に書き込みへのアップグレードを試みます。WAL モードでは、これは次を返しますSQLITE_BUSY_SNAPSHOTそして待っても解決しません。 - 自分のプログラム内の、開いたままのカーソルまたは未完了のステートメントが、読み取りトランザクションを開いたままにしている。
- データベースファイルは、ロックが確実に動作しないネットワークファイルシステムにあります。
修正方法
-
ビジータイムアウトを設定すると、SQLite は即座に失敗せず、待機して再試行します。ほとんどのバインディングで設定できます(Pythonの
sqlite3デフォルトでは 5 秒待機します。引き上げるにはsqlite3.connect(path, timeout=30))。SQL では:PRAGMA busy_timeout = 5000; -- milliseconds
-
データベースを先行書き込みログ(WAL)に切り替えるので、リーダーがライターをブロックせず、ライターもリーダーをブロックしなくなります。
PRAGMA journal_mode = WAL;
-
書き込みトランザクションの開始に使うのは
BEGIN IMMEDIATE、これは書き込みロックを先に取得します。ビジー状態の接続は、その後次で待機しますBEGIN(タイムアウトが適用される箇所)で、途中で失敗するのではなく。BEGIN IMMEDIATE; UPDATE counters SET n = n + 1 WHERE name = 'visits'; COMMIT;
-
トランザクションを短く保ち、すぐにコミットし、すべてのステートメントを完了またはリセットして(カーソルを閉じる)、接続が必要以上に長くロックを保持しないようにします。
-
データベースはネットワーク共有ではなく、ローカルディスクに置いてください。
安全に再現する
同じスクラッチデータベースファイルへの 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_LOCKEDデータベーステーブルはロックされていますSQLITE_BUSY_SNAPSHOT古い読み取りが書き込みに変わることはありませんSQLITE_BUSY_TIMEOUTブロッキングファイルロックがタイムアウトしました55P03PostgreSQL: ロックを取得できません1205MySQL: ロック待ちタイムアウトを超えました1222SQL Server: ロック要求のタイムアウト期間を超過しました
その他のプライマリ結果コードのエラー
SQLITE_ERRORSQL ロジックエラーSQLITE_PERMアクセス権限の拒否SQLITE_ABORTクエリが中止されましたSQLITE_NOMEMメモリ不足SQLITE_READONLY読み取り専用データベースに書き込もうとしましたSQLITE_INTERRUPT中断されたSQLITE_IOERRディスク I/O エラーSQLITE_CORRUPTデータベースのディスクイメージが破損しています
コードとメッセージのテキストは、 SQLite の結果コードとエラーコードのドキュメント。全容は次で参照 SQLite エラーリスト または すべてのデータベースエラーを検索.
SQLly で SQLite を操作する
macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、SQLite をはじめ、お使いの他のデータベースにも対応します。