[Python/Milvus] Milvus-CLI 使用指南

1 概述: Milvus-CLI

1.1 安装

1.1 pip 安装方式

  • 安装

python : 3.10

python.exe -m pip install --upgrade pip

# Python 3.10+ 等版本中，collections.Callable 已被移除，存在新旧版本的兼容性问题，需卸载并安装 pyreadline3
pip uninstall pyreadline -y
pip install pyreadline3

pip install milvus-cli 

milvus_cli --version
> Milvus_CLI v1.2.1

2 案例实践

CASE 登录

  • 推荐文献
  • 完整语法
  • connect [-uri (text)] [-t (text)] [-tls (0|1|2)] [-cert (text)] [--save-as (text)]
C:\Users\EDY> milvus_cli

  __  __ _ _                    ____ _     ___
 |  \/  (_) |_   ___   _ ___   / ___| |   |_ _|
 | |\/| | | \ \ / / | | / __| | |   | |    | |
 | |  | | | |\ V /| |_| \__ \ | |___| |___ | |
 |_|  |_|_|_| \_/  \__,_|___/  \____|_____|___|

Milvus cli version: 1.2.1
Pymilvus version: 2.6.2

Learn more: https://github.com/zilliztech/milvus_cli.

milvus_cli > connect -uri http://192.168.1.134:19530 -t "root:Milvus"
Connect Milvus successfully.
+---------+----------------------------+
| Address | http://192.168.1.134:19530 |
|  Alias  |           default          |
+---------+----------------------------+

CASE 数据库操作

  • 查看数据库列表
milvus_cli > list databases
+----------+
| Database |
+----------+
| default  |
+----------+
  • 创建数据库
milvus_cli > create database -db db_law
Create database db_law successfully!
  • 删除数据库
milvus_cli > delete database -db db_law
Warning!
You are trying to delete database 'db_law' and all its collections. This action cannot be undone!

Do you want to continue? [y/N]: y
Drop database db_law successfully!
  • 切换/使用指定的数据库
milvus_cli > use database -db default
Using database default successfully!

CASE 集合操作

查看

  • 列出所有集合
milvus_cli > list collections
+--------------------+
|     Collection     |
+--------------------+
|  test_collection   |
|  test_collection2  |
|  test_collection4  |
|   sanguo_article   |
| legal_texts_bge_m3 |
+--------------------+
milvus_cli >
  • 查看指定集合
milvus_cli > show collection -c legal_texts_bge_m3
+---------------+------------------------------------------------+
| Name          | legal_texts_bge_m3                             |
+---------------+------------------------------------------------+
| Description   | 法律文本向量库（BGE-M3+语义切分）              |
+---------------+------------------------------------------------+
| Entities      | 4882                                           |
+---------------+------------------------------------------------+
| Is Empty      | False                                          |
+---------------+------------------------------------------------+
| Primary Field | id                                             |
+---------------+------------------------------------------------+
| Schema        | Description: 法律文本向量库（BGE-M3+语义切分） |
|               |                                                |
|               | Fields(* is the primary field):                |
|               |  - *id 5 auto_id: True                         |
|               |  - file_name 21 max_length: 2048               |
|               |  - text 21 max_length: 2048                    |
|               |  - text_type 21 max_length: 100                |
|               |  - vector 101 dim: 1024                        |
+---------------+------------------------------------------------+
| Partitions    | - _default                                     |
+---------------+------------------------------------------------+
| Indexes       | - vector                                       |
+---------------+------------------------------------------------+
milvus_cli >

创建

  • 创建集合

命令详情，参见: create collection --help

https://milvus.io/docs/zh/create-collection.md

加载/释放

https://milvus.io/docs/zh/load-and-release.md

  • 加载集合
milvus_cli > load collection -c legal_texts_bge_m3
Load collection legal_texts_bge_m3 successfully!
  • 查看集合的加载进度
milvus_cli >  show loading_progress -c legal_texts_bge_m3
{'loading_progress': '100%', 'loaded_partitions': ['_default']}
  • 释放某个集合
milvus_cli > release collection -c legal_texts_bge_m3
Release collection legal_texts_bge_m3 successfully!

分区

  • 查看某个集合下的分区
milvus_cli > list partitions -c legal_texts_bge_m3
['_default']

索引

  • 查看某个集合下的索引
milvus_cli > list indexes -c legal_texts_bge_m3
+----+--------------+--------------+--------------+---------------+----------+
|    | Field Name   | Index Name   | Index Type   | Metric Type   | Params   |
+====+==============+==============+==============+===============+==========+
|  0 | vector       | vector       | HNSW         | COSINE        | {}       |
+----+--------------+--------------+--------------+---------------+----------+
milvus_cli >
  • 查看索引的进度
milvus_cli > show index_progress -c legal_texts_bge_m3
{'total_rows': 'Unknown', 'indexed_rows': 'Unknown', 'progress': '100%', 'state': 'Finished'}

CASE 重建

# 导出原集合 schema
milvus_cli > describe "new_collection_name" -c "old_collection_name" > schema.txt

# 手动修改 schema.txt 中的 max_length 值

# 创建新集合并导入数据
milvus_cli > create collection -c new_collection -f schema.txt
milvus_cli > import -c new_collection -p /path/to/data.json

Z FAQ for Milvus-CLI

Y 推荐文献

X 参考文献

posted @ 2026-03-29 12:00  千千寰宇  阅读(5)  评论(0)    收藏  举报