본문 바로가기
Q&A2026년 5월 30일1분 읽기

Cloudflare D1 — SQLite VACUUM이 자동인지 수동인지

권
권석현
조회 816댓글 3

Cloudflare D1을 6개월 운영 중인데 DB 크기가 점진 증가. delete가 많은 워크로드(임시 session 데이터 삭제)인데도 disk usage가 줄어들지 않습니다.

SQLite는 일반적으로 VACUUM 수동 또는 auto_vacuum 설정으로 reclaim 가능한데, D1에서는 어떻게 운영하나요?

// 현재 상태
db_size: 6.8 GB  (1개월 전 4.2 GB)
row_count: 거의 동일 (delete 후 insert)
estimated_unused: 약 2 GB

VACUUM 명령 직접 실행 시도:

wrangler d1 execute mydb --command "VACUUM;"
// Error: VACUUM not permitted in D1

D1 10GB 한도가 가까워지는데 어떻게 압축하나요?

댓글 3

김김영삼5개월 전

D1은 VACUUM을 직접 실행 못 합니다. 다만 두 가지 우회 패턴이 있습니다.


패턴 1 — auto_vacuum INCREMENTAL + PRAGMA


DB 생성 시점에 auto_vacuum 모드 설정 가능. INCREMENTAL 모드면 PRAGMA로 부분 압축.


// 새 DB 생성 시
wrangler d1 create mydb --auto-vacuum incremental

// 기존 DB라면 — 새 DB 만들고 데이터 옮기는 방식만 가능
PRAGMA incremental_vacuum(1000); // 1000 페이지 회수

안타깝게도 기존 DB의 auto_vacuum 모드는 변경 불가. 새 DB를 만들고 데이터 옮기는 게 유일한 해결책입니다.


패턴 2 — D1 export/import (compact 효과)


# 1) Export
wrangler d1 export mydb --output backup.sql

# 2) 새 DB 생성
wrangler d1 create mydb-v2 --auto-vacuum incremental

# 3) Import
wrangler d1 execute mydb-v2 --file backup.sql

# 4) Worker binding 교체

이 과정에서 sqlite_master 재구성 + 페이지 압축됩니다. 6.8 GB → 4.2 GB 정도 회수 예상.


패턴 3 — partition 패턴


session 같은 휘발성 데이터는 별도 DB(D1 인스턴스)에 분리. 분기마다 전체 drop + 재생성.


// 영구 데이터 — main D1
// 휘발 데이터 — sessions D1 (분기마다 drop)

D1 인스턴스 무료(100개), drop은 즉시 disk 회수.


운영 권장



  1. 10GB 한도 도달 전 — export/import로 compact (8 GB 도달 시 작업)

  2. session 같은 휘발성 — 별도 D1로 분리

  3. 새 DB는 auto_vacuum incremental + 주기적 PRAGMA


저희는 매주 일요일 새벽 PRAGMA incremental_vacuum 실행하는 Cron Trigger 설정해뒀습니다. disk usage 안정적.

서서버지기영호5개월 전

D1 10GB 한도 부담스러우면 hot/cold split도 좋습니다. 최근 30일 데이터만 D1, 그 이상은 R2(parquet)로 archive. 분석 쿼리는 R2 + DuckDB-wasm로. D1 disk 증가 멈춥니다.

ccf_admin_park(guest)5개월 전
10GB 한도 가까워지면 Cloudflare에 연락하면 enterprise 옵션으로 더 큰 한도 받을 수 있어요. 그 전에 compact 한 번 시도해서 충분히 줄어드는지 측정해보시면 좋겠습니다.
Ctrl+Enter로 등록