Skip to content

問い合わせで index を使う - #31

Merged
JunNishimura merged 5 commits into
mainfrom
feat/index-select
Oct 25, 2026
Merged

JunNishimura merged 5 commits into
mainfrom
feat/index-select

Conversation

@JunNishimura

Copy link
Copy Markdown
Owner

概要

select の where 句が index のあるフィールドを定数と等しいとするとき、テーブルを全部読む代わりに、index でその値の行だけを読むようにした。SimpleDB の IndexSelectScan / IndexSelectPlan に相当するものを追加し、server が開く DB は、index を使う問い合わせの planner(IndexQueryPlanner)を使う。

前の PR(#30)で、index は文の実行に合わせて保たれるようになった。この PR で、保たれた index が初めて問い合わせの答えに使われる。

  • index
    • SelectScan(query.Scan の実装):index で record id を得て、テーブルのスキャンをその行へ動かす。行の値はテーブルから読む
  • plan
    • IndexSelectPlan:Open で index.SelectScan を返す。コストは IndexInfo から見積もる
    • IndexQueryPlanner(QueryPlanner の実装):BasicQueryPlanner と同じく、テーブルの積、select、project の順に組む。ただし、where 句が index のあるフィールドを定数と等しいとするテーブルは、TablePlan の代わりに IndexSelectPlan で読む
    • constantEquatedWith:述語から「フィールド = 定数」の定数を取り出す。既存の equatesWithConstant もこれを使う形にまとめた
  • server
    • Open が planner に渡す問い合わせの planner を、BasicQueryPlanner から IndexQueryPlanner に変えた

設計上の判断

  • SelectScan は index パッケージに置く。 index はすでに query を import しているので、query に置くと循環する。SimpleDB の simpledb.index.query に対応する。index.IndexSelectScan だと名前が重なるので、SelectScan とした。
  • BasicQueryPlanner は残し、IndexQueryPlanner を別に作る。 BasicQueryPlanner は「何も比べない基準」という位置づけなので、そのままにした。
  • 使える index があれば、いつも使う。 SimpleDB の TablePlanner と同じ。IndexSelectPlan と TablePlan のコストを比べることはしない。小さいテーブルでは表を読む方が安いことが多いが、どの計画になるかを予想しやすい方を選んだ。コストを比べるのは、結合の順番を考える planner を作るときにまとめて入れる。
  • 使える index が複数あれば、コストの小さい方、同じならフィールド名が辞書順で先の方を使う。 カタログに並ぶ順番に左右されないようにするため。
  • index で読んだ後も、select で where 句全体を確かめる。 index が代わりに確かめた項はもう一度確かめられるが、結果は変わらない。index が受け持たない項(id = 7 and name = 'x' の name = 'x' など)を確かめるのに必要。
  • ビューの中のテーブルも index で読む。 ビューの定義を同じ planner で計画し直すため、ビュー自身の where 句が許す範囲で index を使う。
  • IndexSelectPlan.BlocksAccessed は、index を読むブロックに、返す行ごとのテーブルの 1 ブロックを足す。 同じ値の行は隣り合っているとは限らないので、1 行ごとに別のブロックを読むとみなす(SimpleDB と同じ)。

既知の制限

  • 結合(where a = b の形)にはまだ index を使わない。次の PR で、IndexJoinScan / IndexJoinPlan を入れる予定。
  • UPDATE / DELETE の where 句にはまだ index を使わない。今はテーブルを全部読んで、述語が残す行を探す。
  • 範囲の検索(< / >)には使わない。Index インターフェースが等号の検索しか持たないため。
  • BasicQueryPlanner と IndexQueryPlanner の、ビューを展開する部分はほぼ同じ。ビューの中も同じ planner で計画するため、共通にするには planner を引数に取る形になるので、今は 2 か所に置いている。

テスト

  • constantEquatedWith:定数が右・左にある場合、別の項と組み合わさった場合、同じフィールドの項が 2 つある場合(最初の項を取る)、フィールド同士の項・別のフィールドの項・項なし
  • index.SelectScan:先頭・途中・末尾の値、同じ値の 2 行、どの行にもない値、MoveBeforeFirstRecord での読み直し、HasField
  • IndexSelectPlan:Open で読める行、コスト(10 行のテーブルの統計から手で計算した値)、スキーマ
  • IndexQueryPlanner:計画が index を使うか(使うなら何の値で検索するか)と、読める行の両方を確かめる。index の有無、index のないフィールドへの条件、where 句なし、2 つの index から選ぶ場合、index が受け持たない項が残る場合、ビュー、結合、存在しないテーブル
    • Red ではスタブが nil を返して先に止まっていたので、Green の後に「index を一切使わない」ように一時的に壊し、index を使うはずのケースがすべて落ちることを確かめた
  • server:planner を通さずにテーブルへ直接書いた行(index には入らない)が、where 句で index を使う問い合わせでは見つからないこと。server のテストからは計画の中身を見られないので、index を通して読んだときにしか起きない結果で確かめている

🤖 Generated with Claude Code

JunNishimura and others added 5 commits October 25, 2026 15:44
index を検索するには、述語が「フィールド = 定数」とする定数そのものが要る。
既存の equatesWithConstant もこの関数を使う形にまとめ、項のたどり方を 1 か所にした。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
index が返す record id へテーブルのスキャンを動かし、間の行を読まずに目的の行だけを読む。
行の値は index ではなくテーブルから読む。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
述語が index のフィールドを定数と等しいとするとき、テーブルを読む代わりに index で目的の行だけを読む計画。
コストは index を読むブロックに、返す行ごとのテーブルの 1 ブロックを足して見積もる。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…re clause lets it be read through

where 句が index のフィールドを定数と等しいとするテーブルは、index で目的の行だけを読む。
複数の index が使えるときはコストの小さい方、同じならフィールド名が先の方を選び、カタログの並びに左右されないようにした。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…heir where clauses let them be

BasicQueryPlanner は index があってもテーブルを全部読む。
server が開く DB は IndexQueryPlanner を通し、更新だけでなく問い合わせでも index を使う。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@JunNishimura
JunNishimura merged commit 6fb97a1 into main Oct 25, 2026
2 checks passed
@JunNishimura
JunNishimura deleted the feat/index-select branch October 25, 2026 07:45
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