Blosc / Blosc/python-blosc2

Document SUMMARY indexes for end users

オープン
#645 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
documentation good first issue
主要言語
Python
スター
211
フォーク
58
平均マージ
1日 17時間
マージ済み PR(30日)
6

説明

SUMMARY indexes are now built automatically when a CTable is first closed, and they accelerate where() queries by skipping blocks that cannot match the predicate. This is a significant feature but it is only described in the API reference, not in any user-facing guide. The tutorial 15.indexing-ctables.ipynb covers FULL/PARTIAL indexes but does not mention SUMMARY at all.

Suggested work:
- Add a section to 15.indexing-ctables.ipynb explaining: what SUMMARY indexes store (per-block min/max), when they are built automatically, the create_summary_index=False opt-out, and how to verify they are being used.
- Add a short example that measures query time with and without a SUMMARY index on a realistic dataset
- Update doc/reference/ctable.rst to cross-reference the new create_summary_index parameter

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

tutorial 15.indexing-ctables.ipynb と、issue に記載されている SUMMARY インデックスの動作から始め、次に doc/reference/ctable.rst で create_summary_index パラメーターを確認してください。ユーザー向けの説明、オプトアウトと検証の詳細に加えて、SUMMARY インデックスありとなしのクエリを比較する現実的な時間の例を追加してください。両方のドキュメント箇所でこの機能を説明し、パラメーターへの相互参照があれば完了です。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
jupyter-notebook, python
領域
databases, documentation
issue の種類
ドキュメント
難易度
3/5
見積もり時間
1〜2日
活発さ
静か
明瞭さ
明確に書かれている
初心者へのやさしさ
74/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。