// SQLite 오류 참조

SQLITE_LOCKED: 데이터베이스 테이블이 잠겨 있습니다

같은 연결이나 공유 캐시 안의 충돌 때문에 쓰기를 계속할 수 없었습니다. 예를 들어 명령문이 아직 읽고 있는 테이블을 삭제하는 경우입니다.

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

의미

SQLITE_LOCKED (6)은 충돌이 다른 프로세스가 아니라 내 연결 안에서, 또는 캐시를 공유하는 연결들 사이에서 일어났다는 뜻입니다. SQLite 문서의 고전적인 예는 DROP TABLE 같은 연결의 다른 문장이 아직 그 테이블을 읽고 있는 중이기 때문입니다. 삭제하면 읽던 문장의 발밑에서 테이블이 사라집니다.

이것은 다음과는 다릅니다: SQLITE_BUSY, 다른 연결, 대개는 다른 프로세스의 연결이 잠금을 잡고 있다는 뜻입니다. 기다려도 해결되지 않는데 SQLITE_LOCKED; 다른 문장을 끝까지 마쳐야 문제가 해결됩니다.

일반적인 원인

  • 실행 중 DROP TABLE, ALTER TABLE 또는 이와 비슷한 작업을, 다음 SELECT 같은 연결에서 이전 문장이 끝까지 스텝되지 않았거나 초기화되지 않은 상태일 때입니다.
  • 미완성 문장으로 테이블을 순회하는 쿼리를 돌리는 동안 그 테이블에 쓰는 경우도 있습니다.
  • 하나의 연결이 테이블을 수정하면 캐시를 공유하는 다른 연결을 막는 공유 캐시 모드(SQLITE_LOCKED_SHAREDCACHE).

해결 방법

  1. 스키마를 변경하기 전에 모든 문을 마치거나 재설정하거나 종료하세요. Python에서는 모든 행을 먼저 가져오거나 커서를 먼저 닫으세요.

  2. 필요한 행을 먼저 메모리로 읽어 온 뒤 DDL이나 쓰기를 실행하세요.

    -- read first
    SELECT id FROM staging;
    -- then, after the reader is done:
    DROP TABLE staging;
  3. 필요하지 않다면 공유 캐시 모드는 피하세요. SQLite 역시 권장하지 않고, 동시 읽기에는 보통 WAL 모드를 씁니다.

질문

busy timeout을 설정하면 SQLITE_LOCKED가 해결되나요?

아니요. busy 핸들러는 다른 연결과의 충돌(SQLITE_BUSY)을 처리하는 용도입니다. SQLITE_LOCKED는 같은 연결이나 공유 캐시 안에서의 충돌이므로, 해결 방법은 방해가 되는 SQL 문을 끝내거나 리셋하는 것입니다.

관련 오류

그 밖의 기본 결과 코드 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 SQLite 결과 및 오류 코드 문서. 전체 목록은 SQLite 오류 목록 또는 모든 데이터베이스 오류 검색.

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

SQLly에서 SQLite 작업하기

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