Vector indexes page: say which Cloud plans support them, and that a non-prefix filter skips the index
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 88/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- sql
調査の方向性
Vector indexes のページ、特に "Define prefix columns" セクションから始め、報告されている Basic クラスターの測定結果とクエリプランを確認してください。ページを更新して、どの Cloud プランが Vector indexes をサポートしているかを記載し、ベクトル列に対する IS NOT NULL チェックを含む、プレフィックス以外のフィルターによってフルスキャンが発生する可能性があることを、両方のケースを示す EXPLAIN の組み合わせとともに説明してください。
索引モデルが issue の本文から書いたものです。
説明
Page: https://docs.cockroachlabs.com/docs/stable/vector-indexes
Two things I had to measure while building on a CockroachDB Cloud Basic cluster that the page could answer directly.
1. Which Cloud plans support vector indexes. The page doesn't say whether they work on Basic, Standard and Advanced. On a Basic cluster running v26.2.1, on 2026-08-03, SHOW CLUSTER SETTING feature.vector_index.enabled returned true and CREATE VECTOR INDEX completed. A line on plan availability, and on whether the setting is already on for Basic, would save the next person the experiment.
2. What a filter on a non-prefix column does to the plan. The page says an index is only used when each prefix column is constrained, and lists "Index acceleration with filters is only supported if the filters match prefix columns" as a limitation. I read that limitation as "the filter won't be accelerated" and expected a vector search followed by filtering. What I measured was the index skipped entirely. Same Basic cluster, August 2026, statistics freshly collected:
| Filter | Index | Plan |
|---|---|---|
| none | (embedding vector_cosine_ops) |
vector search |
WHERE evicted_at IS NULL |
(embedding vector_cosine_ops) |
FULL SCAN |
WHERE workspace_id = $1 |
(embedding vector_cosine_ops) |
FULL SCAN |
WHERE workspace_id = $1 AND is_live |
(workspace_id, is_live, embedding vector_cosine_ops) |
vector search, prefix spans |
WHERE workspace_id = $1 AND is_live AND embedding IS NOT NULL |
(workspace_id, is_live, embedding vector_cosine_ops) |
FULL SCAN |
The query was SELECT ... FROM memory WHERE <filter> ORDER BY embedding <=> $2::VECTOR LIMIT $3. The last row surprised me most: an IS NOT NULL check on the vector column itself was enough to lose the index.
Suggested addition under "Define prefix columns": one sentence saying that when a query also filters on a column that isn't a prefix column, the optimizer doesn't use the vector index and falls back to a full scan, with an EXPLAIN pair showing both cases.
Jira issue: DOC-19240
- 主要言語
- HTML
- スター
- 212
- フォーク
- 477
- PR マージ指標
- 30日以内にマージされた PR はありません
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
似ている issue
-
TLS guide repeats certs/ in the certificate directory対応中かも @maheshrijal が今日担当しました。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 92/100
prometheus/docs#3156 ·
メンテナーはふだん 2 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 75/100
メンテナーはふだん 1 日以内に返信
-
feedback simulation workshop
難易度 2/5 1〜3時間 初心者へのやさしさ 64/100
githubnext/gh-aw-workshop#5009 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
-
Course help wanted Sensei
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100