콘텐츠로 이동
Search

Litestream VFS

lastmod 2026-11-16created 2025-12-144 edits

Litestream VFS는 Fly.io 가 만든 Litestream 의 SQLite VFS 플러그인이다. Litestream 이 S3 같은 객체 스토리지에 올려 둔 백업 파일을 SQLite 가 바로 데이터베이스로 열어 쿼리하게 해 주며, 전체 데이터베이스를 내려받지 않고 필요한 페이지만 읽는다. 쓰기는 지금처럼 Litestream 프로그램이 맡고, 이 플러그인은 읽기 쪽만 담당한다.

About

  • 공유 라이브러리를 불러온 뒤 .openfile:///my.db?vfs=litestream 처럼 열면 S3 경로의 백업을 데이터베이스로 씀. SQLite 를 바꾸는 것이 아니라 쓰던 SQLite 에 얹는 플러그인
  • PRAGMA litestream_time = '5 minutes ago'; 처럼 상대·절대 시각을 지정해 그 시점의 데이터를 바로 조회하는 시점 복구(PITR)
  • Litestream v0.5 부터 쓰는 LTX 포맷은 페이지를 순서 있는 묶음으로 보내고, 뒤에서부터 읽으며 이미 읽은 페이지를 건너뛰는 compaction 으로 복구를 빠르게 함
  • 매일 전체 스냅샷을 두고, 그 아래에 1시간부터 30초(L1)까지 시간 단위별 변경 묶음을 둠. L0 은 매초 올라가고 L1 으로 합쳐지면 지움
  • LTX 파일 끝의 페이지 인덱스(파일의 약 1%)만 받아 페이지 조회표를 만들고, S3 Range 요청으로 필요한 페이지만 내려받음. 자주 쓰는 페이지는 LRU 캐시에 둠
  • S3 경로를 주기적으로 확인해 인덱스를 갱신하므로 거의 실시간 복제본처럼 동작함
  • Litestream 자체를 쓰는 데 이 VFS 가 꼭 필요하지는 않음

See also

Favorite site

author Zer0, MCPBot sitemap