Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Vector indexes page: say which Cloud plans support them, and that a non-prefix filter skips the index

Đang mở
  • Có gì không ổn?
#23,467 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
88/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
sql
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với trang Vector indexes, đặc biệt là phần "Define prefix columns", và xem lại các số liệu đo được cùng kế hoạch truy vấn đã báo cáo cho Basic-cluster. Cập nhật trang để nêu rõ những gói Cloud nào hỗ trợ Vector indexes và giải thích rằng các bộ lọc không có tiền tố, bao gồm cả kiểm tra IS NOT NULL trên một cột vector, có thể khiến hệ thống quét toàn bộ, kèm theo một cặp EXPLAIN cho thấy cả hai trường hợp.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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

Ngôn ngữ chính
HTML
Star
212
Fork
477
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue tương tự

Thêm issue về Documentation

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.