Skip to content

bookmarks に処理の状態・最後に開いた日時・保存した日時のインデックスを足し、よく読み直す問い合わせで全件を読まずに済むようにする(DB v30) - #104

Merged
unchunks merged 2 commits into
developfrom
fix/bookmark-indexes
Nov 15, 2026

Conversation

@unchunks

Copy link
Copy Markdown
Owner

概要

「ときどきとても重くなる」の調査の4本目(#98・#101・#102 の続き)。bookmarks には contentUri のインデックスしか無く、よく読み直す問い合わせが毎回全件を読んでいた。aiStatus・lastAccessedAt・createdAt のインデックスを足す。スキーマの変更(DB v29 → v30)。バックアップの版は変わらない(v22 のまま)。

事前に確かめたこと: 開いている PR で AppDatabase.VERSION を上げているものは無い(#7 は develop → main、#99・#103 はスキーマに触れない)。

原因(根拠)

EXPLAIN QUERY PLAN(下の測ったテストで出したもの):

  • 処理の状況(WHERE aiStatus IN ('PENDING', 'PROCESSING')): SCAN bookmarks(全件)。処理待ちが数十件でも、毎回 5,000 件を読む
  • 再発見の候補(ORDER BY lastAccessedAt, id LIMIT 30): SCAN bookmarks / USE TEMP B-TREE FOR ORDER BY(全件を読んで並べ替えてから先頭 30 件)
  • aiStatus・lastAccessedAt・createdAt は、行の中で本文(content)より後ろにある。本文が1ページに収まらない行では、SQLite はこれらの列を読むのに本文のはみ出したページまでたどる。端末の DB は SQLCipher で暗号化しているので、ページを読むたびに復号も入る

これらの問い合わせは Room の Flow で、ブックマークが変わるたびに読み直される(処理の状況の画面とウィジェットの進み具合、ウィジェットの候補、一覧上部の「次に読む」)。

変更内容

  • BookmarkEntity に Index("aiStatus")・Index("lastAccessedAt")・Index("createdAt")
  • MIGRATION_29_30: CREATE INDEX IF NOT EXISTS を3つ(30.json の createSql と同じ)。列・行は変えない。AppDatabase.VERSION = 30、30.json を足した
  • SQLite のインデックスは rowid(= id)も持つので、ORDER BY lastAccessedAt, id・ORDER BY createdAt DESC, id DESC もそのまま使える
  • 一覧の問い合わせ(observeFiltered)の並べ替えは CASE 式なので、インデックスでは速くならない(この PR の対象外)

測った結果

BookmarkIndexPerformanceTest(Robolectric、ファイルの DB): 5,000 件(本文 約 2,000 字、処理待ち 32 件・失敗 10 件)。同じ DB で、インデックスあり → 3つを消したもの(v29 まで)と比べ、結果が同じことも確かめている。中央値:

問い合わせ インデックスなし あり
再発見ウィジェットの候補(古い順 30 件) 46.4 ms 2.0 ms
再発見の通知の候補(getStale) 66.0 ms 8.3 ms
次に読むの候補(未読の新しい順 30 件) 105.0 ms 16.7 ms
最近読んだもの(20 件) 104.3 ms 16.7 ms
処理の状況(処理待ち・処理中) 73.7 ms 8.7 ms
処理に失敗したもの(20 件) 102.3 ms 9.5 ms
  • 計画: 処理の状況は SEARCH bookmarks USING COVERING INDEX index_bookmarks_aiStatus (aiStatus=?)、再発見の候補は SCAN bookmarks USING COVERING INDEX index_bookmarks_lastAccessedAt(並べ替えの一時の木が要らなくなる)
  • 初めはメモリ上の DB で測ったが、そこでは差が 1.3〜1.6 倍と小さかった(本文のはみ出したページをたどるのがメモリのコピーで済むため)。端末に近いファイルの DB で測り直した。端末では暗号化(SQLCipher)の復号も入るので、差はさらに大きいと考える(未計測)
  • 書き込みはインデックス3つ分だけ重くなる(1行の追加・処理の状態の更新ごとにインデックスの更新が入る)。測っていないが、読み直しの回数の方がずっと多い

テスト

端末で確かめること(未検証)

  • 実機の暗号化した DB での効き目(Android Studio の Database Inspector で同じ問い合わせの時間、または Perfetto で Room の問い合わせのスレッド)
  • v29 の DB を持つ端末で更新したときに、インデックスを作る時間(数千件で数十〜数百ミリ秒の見込み。最初に DB を開くとき、裏のスレッドで1回だけ)

🤖 Generated with Claude Code

unchunks and others added 2 commits November 15, 2026 20:45
…(DB v30)

- aiStatus: 処理の状況(処理待ち・処理中・失敗)。ほとんどの行は処理済みなので、全件を見ずに済む
- lastAccessedAt: 再発見(ウィジェット・通知の候補。古い順の先頭だけ)、最近読んだもの
- createdAt: 未読の新しい順の先頭だけ(「次に読む」)、保存した期間での絞り込み
- MIGRATION_29_30 は CREATE INDEX だけ(列・行は変えない)。30.json を足した。バックアップの版は変わらない
- マイグレーションのテストと、インデックスあり・なしで同じ問い合わせを比べるテスト(BookmarkIndexPerformanceTest)を足した

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant