Skip to content

feat: add AliyunMilvus DISKANN support#795

Open
frankleaf wants to merge 6 commits into
zilliztech:mainfrom
frankleaf:aliyun-milvus-diskann
Open

feat: add AliyunMilvus DISKANN support#795
frankleaf wants to merge 6 commits into
zilliztech:mainfrom
frankleaf:aliyun-milvus-diskann

Conversation

@frankleaf

Copy link
Copy Markdown
  • Summary
    Add AliyunMilvus as a new VectorDBBench target and only extends the existing Milvus DISKANN config with three opt-in search-time parameters.

  • What's added
    New AliyunMilvusDiskANN type. It reuses the upstream Milvus client and MilvusConfig unchanged (no dedicated client class, no dedicated DB config).
    New CLI command: vectordbbench aliyunmilvusdiskann ...
    AliyunMilvusDISKANNConfig extends the existing Milvus DISKANNConfig and adds three opt-in search-time params:

    • rerank_topk_multiplier
    • early_termination_threshold
    • cross_segment_rerank
  • Supported index
    Only DISKANN is exposed for AliyunMilvus. Other index types are not silently mapped to upstream Milvus configs.

  • Example

vectordbbench aliyunmilvusdiskann \
  --case-type Performance768D10M \
  --k 10 \
  --num-concurrency 400 \
  --uri <uri> \
  --user-name <user-name> \
  --password <pass> \
  --search-list 300 \
  --replica-number 1 \
  --num-shards 1 \
  --concurrency-duration 30 \
  --rerank-topk-multiplier 1 \
  --early-termination-threshold 30 \
  --cross-segment-rerank

Omitting any of --rerank-topk-multiplier / --early-termination-threshold / --cross-segment-rerank (or --no-cross-segment-rerank) means that param is not sent, so the run behaves exactly like milvusdiskann.

frankleaf and others added 6 commits June 8, 2026 12:20
…ch params

Add an AliyunMilvus client (modeled on the VolcanoMilvus DISKANN client)
that exposes DISKANN build knobs and three search-time knobs:
rerank_topk_multiplier, early_termination_threshold and cross_segment_rerank.

The three search params are optional and only injected into the per-query
search params when explicitly specified (None = not sent, server keeps its
own default). 0 is preserved as a meaningful value; a negative/"DEFAULT"
sentinel from the UI is normalized to None.

Wires up CLI command `aliyunmilvusdiskann`, the DB registry, and the
Streamlit web UI (dbCaseConfigs + CaseConfigParamType entries).

Co-authored-by: Cursor <cursoragent@cursor.com>
…arams

Drop the Volcano-style scaffolding that is not needed for this use case:
remove the dedicated AliyunMilvus client class and db config, and all the
extra index-build knobs (max_degree/store_strategy/quant_type/
distance_strategy/enable_thp/enable_prefetch/build_search_list/legacy).

AliyunMilvus now reuses the upstream Milvus client and MilvusConfig as-is;
the only difference is AliyunMilvusDISKANNConfig, which extends the existing
DISKANNConfig with the three opt-in search params and injects them into the
search params only when explicitly specified.

Co-authored-by: Cursor <cursoragent@cursor.com>
…init__

- Remove the empty aliyun_milvus/__init__.py: like milvus/ (and most client
  dirs) it is an implicit namespace package; the marker was unnecessary.
- Wrap the case config with _with_partition_key, mirroring the MilvusDISKANN
  command, so AliyunMilvus is literally "Milvus DISKANN + 3 opt-in search
  params" with identical behavior otherwise.

Co-authored-by: Cursor <cursoragent@cursor.com>
- Add tests/test_aliyun_milvus.py covering: reuse of the upstream Milvus
  client/config, opt-in search params (omitted by default, injected only when
  set), 0 treated as a real value, UI sentinel (-1 / "DEFAULT") -> unset,
  frontend exposure in Performance (not Load), and DISKANN-only case mapping.
- README: add aliyunmilvus to the default (pymilvus) client row.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add parametrized cases for cross_segment_rerank string/int coercion so
config.py reaches 100% coverage. Tidy README default-client wording.

Co-authored-by: Cursor <cursoragent@cursor.com>
Explicit --no-cross-segment-rerank must send cross_segment_rerank=False
(disable), not omit it. Omission is the only "unset" path.

Co-authored-by: Cursor <cursoragent@cursor.com>
@sre-ci-robot

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: frankleaf
To complete the pull request process, please assign xuanyang-cn after the PR has been reviewed.
You can assign the PR to them by writing /assign @xuanyang-cn in a comment when ready.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@frankleaf

Copy link
Copy Markdown
Author

/assign @XuanYang-cn

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.

2 participants