// SQLite 오류 참조

SQLITE_BUSY: 데이터베이스가 잠겨 있습니다

다른 연결이 SQLite가 필요로 하는 잠금을 잡고 있으며, 보통은 다른 프로세스의 쓰기 작업입니다. busy timeout(대기 시간 제한)을 설정하거나, 쓰기 트랜잭션을 짧게 유지하거나, WAL 모드로 전환하세요.

결과 코드
SQLITE_BUSY
이름
5
카테고리
주요 결과 코드
오류 메시지
database is locked

의미

SQLite는 데이터베이스 파일 하나에 대해 한 번에 하나의 쓰기 연결만 허용합니다. 어떤 연결이 다른 연결(같은 프로세스든 다른 프로세스든)이 쥔 잠금이 필요해지면 호출은 실패하며 SQLITE_BUSY 그리고 메시지 database is locked, busy 핸들러가 설정된 경우에는 SQLite가 먼저 타임아웃까지 재시도합니다.

기본적으로는 busy 핸들러가 없어 실패가 즉시 일어납니다. 롤백 저널 모드에서는 읽기가 쓰기의 커밋을 막고, 커밋 중인 쓰기는 새 읽기를 막습니다. WAL 모드에서는 읽기와 쓰기 하나가 동시에 동작할 수 있습니다.

일반적인 원인

  • 두 프로세스나 스레드가 같은 데이터베이스에 동시에 쓰고 있는데 busy 타임아웃이 설정되어 있지 않습니다.
  • 긴 쓰기 트랜잭션(또는 BEGIN )은 다른 트랜잭션이 대기하는 동안 잠금을 유지합니다.
  • 읽기 트랜잭션이 BEGIN DEFERRED 다른 연결이 쓰고 있을 때 쓰기로 업그레이드하려 하면, WAL 모드에서는 SQLITE_BUSY_SNAPSHOT 그리고 기다려도 소용이 없습니다.
  • 자기 프로그램 안에서 열어 둔 커서나 끝내지 않은 문이 읽기 트랜잭션을 열어 둡니다.
  • 데이터베이스 파일이 잠금이 제대로 동작하지 않는 네트워크 파일 시스템에 있습니다.

해결 방법

  1. SQLite가 한 번에 실패하지 않고 기다렸다가 재시도하도록 busy timeout을 설정하세요. 대부분의 바인딩이 이를 제공하며(Python의 sqlite3 은 기본적으로 5초를 기다립니다; 다음으로 늘릴 수 있습니다 sqlite3.connect(path, timeout=30)). SQL로 쓰면:

    PRAGMA busy_timeout = 5000;  -- milliseconds
  2. 데이터베이스를 쓰기 선행 로깅(write-ahead logging)으로 전환하세요. 그러면 읽기가 쓰기를, 쓰기가 읽기를 막는 일이 사라집니다.

    PRAGMA journal_mode = WAL;
  3. 쓰기 트랜잭션은 다음으로 시작하세요 BEGIN IMMEDIATE, 쓰기 잠금을 미리 잡습니다. 바쁜 연결은 중간에 실패하는 대신 다음에서 대기합니다 BEGIN (타임아웃이 적용되는 위치에서) 중간에 실패하는 대신 끝까지 기다립니다.

    BEGIN IMMEDIATE;
    UPDATE counters SET n = n + 1 WHERE name = 'visits';
    COMMIT;
  4. 트랜잭션은 짧게 유지하고 즉시 커밋하며, 모든 명령문을 완료하거나 재설정(커서 닫기)하여 어떤 연결도 필요 이상으로 잠금을 유지하지 않도록 합니다.

  5. 데이터베이스는 네트워크 공유가 아닌 로컬 디스크에 보관하세요.

안전하게 재현하세요

동일한 스크래치 데이터베이스 파일에 대해 두 개의 별도 연결을 사용합니다.

-- 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 결과 및 오류 코드 문서. 전체 목록은 SQLite 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 SQLite 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. SQLite는 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.