SQLITE_BUSY: 데이터베이스가 잠겨 있습니다
다른 연결이 SQLite가 필요로 하는 잠금을 잡고 있으며, 보통은 다른 프로세스의 쓰기 작업입니다. busy timeout(대기 시간 제한)을 설정하거나, 쓰기 트랜잭션을 짧게 유지하거나, WAL 모드로 전환하세요.
- 결과 코드
SQLITE_BUSY- 이름
5- 카테고리
- 주요 결과 코드
의미
SQLite는 데이터베이스 파일 하나에 대해 한 번에 하나의 쓰기 연결만 허용합니다. 어떤 연결이 다른 연결(같은 프로세스든 다른 프로세스든)이 쥔 잠금이 필요해지면 호출은 실패하며 SQLITE_BUSY 그리고 메시지 database is locked, busy 핸들러가 설정된 경우에는 SQLite가 먼저 타임아웃까지 재시도합니다.
기본적으로는 busy 핸들러가 없어 실패가 즉시 일어납니다. 롤백 저널 모드에서는 읽기가 쓰기의 커밋을 막고, 커밋 중인 쓰기는 새 읽기를 막습니다. WAL 모드에서는 읽기와 쓰기 하나가 동시에 동작할 수 있습니다.
일반적인 원인
- 두 프로세스나 스레드가 같은 데이터베이스에 동시에 쓰고 있는데 busy 타임아웃이 설정되어 있지 않습니다.
- 긴 쓰기 트랜잭션(또는
BEGIN)은 다른 트랜잭션이 대기하는 동안 잠금을 유지합니다. - 읽기 트랜잭션이
BEGIN DEFERRED다른 연결이 쓰고 있을 때 쓰기로 업그레이드하려 하면, WAL 모드에서는SQLITE_BUSY_SNAPSHOT그리고 기다려도 소용이 없습니다. - 자기 프로그램 안에서 열어 둔 커서나 끝내지 않은 문이 읽기 트랜잭션을 열어 둡니다.
- 데이터베이스 파일이 잠금이 제대로 동작하지 않는 네트워크 파일 시스템에 있습니다.
해결 방법
-
SQLite가 한 번에 실패하지 않고 기다렸다가 재시도하도록 busy timeout을 설정하세요. 대부분의 바인딩이 이를 제공하며(Python의
sqlite3은 기본적으로 5초를 기다립니다; 다음으로 늘릴 수 있습니다sqlite3.connect(path, timeout=30)). SQL로 쓰면:PRAGMA busy_timeout = 5000; -- milliseconds
-
데이터베이스를 쓰기 선행 로깅(write-ahead logging)으로 전환하세요. 그러면 읽기가 쓰기를, 쓰기가 읽기를 막는 일이 사라집니다.
PRAGMA journal_mode = WAL;
-
쓰기 트랜잭션은 다음으로 시작하세요
BEGIN IMMEDIATE, 쓰기 잠금을 미리 잡습니다. 바쁜 연결은 중간에 실패하는 대신 다음에서 대기합니다BEGIN(타임아웃이 적용되는 위치에서) 중간에 실패하는 대신 끝까지 기다립니다.BEGIN IMMEDIATE; UPDATE counters SET n = n + 1 WHERE name = 'visits'; COMMIT;
-
트랜잭션은 짧게 유지하고 즉시 커밋하며, 모든 명령문을 완료하거나 재설정(커서 닫기)하여 어떤 연결도 필요 이상으로 잠금을 유지하지 않도록 합니다.
-
데이터베이스는 네트워크 공유가 아닌 로컬 디스크에 보관하세요.
안전하게 재현하세요
동일한 스크래치 데이터베이스 파일에 대해 두 개의 별도 연결을 사용합니다.
-- 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 모드가 '데이터베이스가 잠겼습니다' 문제를 없애나요?
대부분의 읽기-쓰기 간 차단은 제거되지만, 여전히 한 번에 하나의 작성자만 쓸 수 있으므로 동시 쓰기에는 여전히 busy timeout(잠금 대기 제한 시간)이 필요합니다.
관련 오류
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 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. SQLite는 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.