db-maintenance

DB 유지보수

<home>/data/tiguclaw.db 한 파일에 기억·세션·대화 기록이 전부 있다. 그래서 이 문서의 순서는 백업 → 용량 → 아카이브다. 크기는 나중에 문제가 되지만 백업은 처음부터 문제다.

0. 먼저 잰다 — 숫자를 여기서 읽지 말고 지금 재라

★이 문서에 "현재 몇 MB · 몇 년 뒤 1GB" 같은 기준선을 적어두지 않는다. 그런 값은 적는 순간부터 늙고, 다음 사람이 그걸 사실로 믿는다(실제로 이 문서가 두 번 틀린 수치를 들고 있었다 — 한 번은 증가율을, 한 번은 그 근거를). 재는 법만 둔다.

DB="<home>/data/tiguclaw.db"
sqlite3 "$DB" "
WITH sz AS (SELECT
    (SELECT SUM(pgsize) FROM dbstat WHERE name='transcripts') t,
    (SELECT SUM(pgsize) FROM dbstat WHERE name LIKE 'transcripts_fts%') f,
    (SELECT page_count*page_size FROM pragma_page_count(), pragma_page_size()) total),
 grow AS (SELECT sum(length(content))*1.0 c, (max(ts)-min(ts))/86400000.0 days
    FROM transcripts WHERE ts > (strftime('%s','now')-30*86400)*1000)
SELECT
 '현재 '||round(total/1048576.0)||'MB (대화 '||round(t/1048576.0)||' + 색인 '||round(f/1048576.0)||' = '||round(100.0*(t+f)/total)||'%)',
 '월 증가 ~'||round((c/nullif(days,0))*30*(1.0+f*1.0/nullif(t,0))/1048576.0)||'MB',
 '1GB 까지 '||round((1073741824.0-total)/nullif((c/nullif(days,0))*30*(1.0+f*1.0/nullif(t,0)),0)/12.0,1)||'년'
FROM sz, grow;"

★증가는 대화 원문만 세면 틀린다 — 검색 색인이 원문에 비례해 따라 붙는다(그 비율도 위 쿼리가 현재 값으로 잰다). 원문만 세서 증가율을 절반으로 잡은 적이 있다.

판정: transcripts(대화 원문) + transcripts_fts(그 색인)가 대부분이면 정상이다 — 둘 다 설계상 무한 증가고 대화가 쌓이는 만큼 는다. events 는 상한이 있어 안 는다. 1GB 까지 몇 년이 남았는지가 구조를 바꿀 때인지 아닌지의 눈금이고, SQLite 는 수 GB 도 잘 다루므로 수백 MB 에서 손대는 건 이르다.

1. 백업 — 이미 자동으로 돈다

★먼저 이것부터 알아라: 백업은 v0.27.0 부터 자동이다. 스케줄이 아니라 데몬 유지보수 루프(코어 자기보전 루프(core/self-maintenance) → store/backup.ts)에서 하루 한 벌씩 VACUUM INTO 로 뜨고 7벌만 남긴다. 스케줄 목록에는 안 보인다 — 없다고 "백업 체계가 없다"고 결론내지 마라(실제로 그렇게 오판한 적이 있다. 그리고 중복 스케줄을 제안할 뻔했다).

상태 확인은 두 가지로:

/status                     → "백업: 3시간 전 · 7벌 (940MB)" 한 줄
ls -lt <home>/data/backup/  → 실제 파일

성공은 일부러 조용하다(매일 알림은 배경 소음이 된다). 실패와 첫 벌만 알린다. 끄려면 settings.json 의 backup.enabled: false — 기본은 켜짐이다.

손으로 한 벌 더 뜨려면:

mkdir -p "<home>/data/backup"
sqlite3 "$DB" "VACUUM INTO '<home>/data/backup/tiguclaw-$(date +%F).db'"