[DB] SQLite: 단일 파일, WAL 모드, edge / mobile

SQLite, WAL mode, embedded database, Litestream, Turso, single file DB

정의

SQLite 는 세계에서 가장 많이 배포된 DB (모든 스마트폰, 브라우저, OS). 서버 없이 라이브러리, 단일 파일, zero-config. embedded + edge 의 표준.

핵심 특성

항목	SQLite
구조	단일 파일 (.db)
프로세스	없음 (앱 안 라이브러리)
동시성	동시 reader 다수, writer 1개
트랜잭션	ACID
크기	라이브러리 ~600KB
SQL 표준	부분 (SQL-92 의 일부)
Type	dynamic typing (TYPE AFFINITY)

Journal Mode

flowchart LR
    Q{journal_mode}
    Q --> DELETE["DELETE (기본)<br/>rollback journal 사용"]
    Q --> WAL["WAL (권장)<br/>write-ahead log"]
    Q --> MEMORY["MEMORY<br/>rollback 메모리"]
    Q --> OFF["OFF<br/>crash 위험"]

WAL 모드 (운영 권장)

PRAGMA journal_mode=WAL;
PRAGMA synchronous=NORMAL;

모드	reader vs writer	동시성
DELETE (기본)	writer 가 reader 막음	낮음
WAL	분리. reader 가 옛 snapshot 봄	높음

적합한 사용처

flowchart TD
    Q{환경}
    Q --> A[모바일 / 데스크톱 앱]
    Q --> B[Edge / Serverless]
    Q --> C[테스트 DB]
    Q --> D["작은 웹 사이트<br/>(write 적음)"]
    Q --> E[설정 / 캐시 파일]
    Q --> F[Local-first 앱]

부적합:

• write throughput 큰 멀티 노드
• cross-server 트랜잭션 필요

옛 평가와 현재 (2026)

“SQLite 는 장난감” 은 수년 전 평가.

옛 주장	현재 (2026)
writer 1개	1 writer * 분 단위 1만 commit. 대부분 충분
백업 어려움	Litestream, LiteFS, Turso 가 실시간 streaming
분산 안 됨	Turso (libSQL), Cloudflare D1 = edge 분산
큰 쿼리 느림	인덱스 잘 박으면 PostgreSQL 비교 가능

Litestream / LiteFS

flowchart LR
    App[App] --> SQLite[(local SQLite)]
    SQLite -->|WAL stream| Litestream[Litestream]
    Litestream --> S3[(S3 / R2)]
    Replica[다른 노드] -.replicate.-> S3

• 실시간 streaming 백업 (1초 지연).
• S3, GCS, ABS, R2 어디든.
• 마치 Postgres WAL streaming 처럼.

libSQL / Turso

• libSQL = SQLite fork. async/await, embedded replica, vector search.
• Turso = libSQL 의 서버리스 클라우드.
• 2026 시점 edge DB 의 표준 으로 빠르게 성장.

동시성: BEGIN IMMEDIATE

-- 기본 (DEFERRED): 첫 write 명령 시 lock 시도 → SQLITE_BUSY 위험
BEGIN;
SELECT ...;  -- shared lock
UPDATE ...;  -- exclusive lock 시도 → 다른 writer 와 충돌 가능
COMMIT;

-- IMMEDIATE: 시작 시 이미 write lock
BEGIN IMMEDIATE;
SELECT ...;
UPDATE ...;
COMMIT;

Type Affinity (NUMERIC, INTEGER, REAL, TEXT, BLOB)

-- SQLite 는 *dynamic typing*. 컬럼 타입은 *affinity hint*.
CREATE TABLE t (id INTEGER, name TEXT);
INSERT INTO t VALUES ('not number', 42);   -- 동작! (strict 모드 끄면)

-- 3.37+ STRICT 모드
CREATE TABLE t (id INTEGER, name TEXT) STRICT;
INSERT INTO t VALUES ('not number', 42);   -- 에러

흔한 함정

관련 위키

• postgresql, mysql-innodb
• wal-write-ahead-log
• mvcc