Skip to content

結合で index を使う - #32

Merged
JunNishimura merged 4 commits into
mainfrom
feat/index-join
Oct 25, 2026
Merged

JunNishimura merged 4 commits into
mainfrom
feat/index-join

Conversation

@JunNishimura

Copy link
Copy Markdown
Owner

概要

select の where 句が 2 つのテーブルのフィールドを等しいとするとき(from other, test where oid = id など)、積を作ってから条件を確かめる代わりに、左の行ごとに右のテーブルの index を検索して、合う行だけを読むようにした。SimpleDB の IndexJoinScan / IndexJoinPlan に相当するものを追加し、IndexQueryPlanner が結合にも index を使う。

これまでの結合は ProductPlan だけで、左の行ごとに右のテーブルを最初から全部読み直していた。index で結合すると、右のテーブルを全部読む代わりに、左の行ごとに index を 1 回検索して、合う行だけを読む。

  • index
    • JoinScan(query.Scan の実装):左の行ごとに、その行の結合フィールドの値で index を検索し、右のテーブルのスキャンを返った record id の行へ動かす。値は、右にあるフィールドなら右から、なければ左から読む
  • plan
    • IndexJoinPlan:Open で index.JoinScan を返す
    • IndexQueryPlanner:from 句の次のテーブルを足すとき、where 句がそのテーブルの index のあるフィールドを左のフィールドと等しいとするなら、ProductPlan の代わりに IndexJoinPlan を使う

server はすでに IndexQueryPlanner を使っているので、server の変更はない。

設計上の判断

  • IndexJoinPlan.BlocksAccessed は「左を 1 回読む + 左の行数 × index の 1 回の検索 + 返る組の数」。 最後の項は、返る組ごとに右のテーブルの行を読む分で、IndexSelectPlan と同じく、1 組につき 1 ブロックとみなす。返る組の数は「左の行数 × 右のテーブルで 1 つの値を持つ行の数の平均」(SimpleDB と同じ)。
  • 右のテーブルが定数の index でも読めるときは、コストを比べる。 積は左の行ごとに右を読み直すので、定数で右が数行に絞れるときは積の方が安く、そうでなければ結合の index の方が安い。どちらが安いかはデータで変わるので、BlocksAccessed の小さい方を選び、同じなら結合の index を選ぶ(cheaperJoin)。定数の index が使えないときは、使える結合の index をいつも使う(問い合わせで index を使う #31 の「使える index はいつも使う」と同じ)。
  • index で結合するのは、from 句で後から足すテーブルだけ。 テーブルの順番は入れ替えないので、from a, b where a.x = b.y で使うのは b.y の index だけで、a.x の index は使わない。順番の入れ替えは、コストを比べる planner の仕事として残す。
  • 左右に同じ名前のフィールドがある項では、index で結合しない。 フィールド名にテーブル名が付かないので、どちらのフィールドか決められないため。
  • 結合の index が複数使えるときは、コストの小さい方、同じならフィールド名が辞書順で先の方を使う。 定数の index の選び方(問い合わせで index を使う #31)と同じ。
  • index で結合した後も、select で where 句全体を確かめる。 結合の index が受け持たない項(name = 'name1' など)を確かめるため。

既知の制限

  • テーブルの順番を入れ替えない。index を使えるかどうかが、from 句の順番に左右される。
  • 左右に同じ名前のフィールドがあるときに index 結合を使わないことは、実装に入れたが、テストでは確かめていない。テスト用のテーブルに、名前の重なるフィールドがないため。
  • UPDATE / DELETE の where 句には、まだ index を使わない。
  • BasicQueryPlanner と IndexQueryPlanner の、ビューを展開する部分はほぼ同じで、2 か所に置いたまま(問い合わせで index を使う #31 と同じ)。

テスト

  • index.JoinScan:左の値ごとに右の行と組になること、右に合う行がない左の行を飛ばすこと、左の 1 行に右の 2 行が合う場合、何も合わない場合、左が空の場合、左の順番で返ること、MoveBeforeFirstRecord での読み直し、HasField
  • IndexJoinPlan:Open で読める組(右にない値を飛ばす場合、左が空の場合を含む)、コスト(3 行と 20 行のテーブルの統計から手で計算した値)、DistinctValues、スキーマ
    • Red ではスタブが nil を返して先に止まっていたので、Green の後に 3 通りに壊して(コストの最後の項を抜く、DistinctValues で左を見ない、Open で右を読まない)、それぞれ対応するアサーションが落ちることを確かめた
  • IndexQueryPlanner:結合の index を使うか(使うなら左のどのフィールドで結合するか)と、読める組の両方を確かめる。from 句の順番、等号の左右、index の有無、index のないフィールド、定数の index と結合の index の両方が使える場合
  • cheaperJoin:テスト用の DB ではどのフィールドの統計も同じ式で見積もられ、2 つの計画のコストがほとんど同じになるので、コストを決められる fake の計画で、積の方が安いときに積を選ぶことを確かめた
  • server:planner を通さずに右のテーブルへ直接書いた行(index には入らない)が、SQL の結合で組にならないこと。問い合わせの planner を BasicQueryPlanner に戻すと落ちることを確かめた

🤖 Generated with Claude Code

JunNishimura and others added 4 commits October 25, 2026 19:43
…dex files under their join values

左の行ごとにその結合値で index を検索し、結合が残す右の行だけを読む。
積のように左の行ごとに右を全部読み、条件を上の select に任せることをしない。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ndex on the table

左の行ごとに右のテーブルの index を検索する結合の計画。
コストは、左を 1 回読むブロックに、左の行ごとの index の検索と、返る組ごとのテーブルの 1 ブロックを足して見積もる。

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

where 句が後から足すテーブルの index のフィールドを、左のフィールドと等しいとするなら、積の代わりに index で結合する。
右が定数の index でも読めるときは、積と結合のコストを比べて安い方を選ぶ。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…it adds

結合の index は plan で実装済みで、ここでは server が開く DB で、SQL の結合が index を通して答えられることを確かめる。
問い合わせの planner を BasicQueryPlanner に戻すと落ちることを確認した。

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