Milvus_CLI 命令参考

Milvus 命令行界面（CLI）是一个命令行工具，支持数据库连接、数据操作和数据导入导出。

本主题介绍所有支持的命令和相应的选项。还包括一些示例供您参考。

清除

清除屏幕。

语法

clear

选项

选项	全称	说明
-帮助	不适用	显示命令使用帮助。

连接

连接 Milvus。

语法

connect [-uri (text)] [-t (text)]

选项

选项	全名	说明
-uri	-uri	(可选）uri 名称。默认为 "http://127.0.0.1:19530"。
-t	-令牌	(可选）Zilliz Cloud Apikey 或username:password 。默认为 "无"。
-help	无	显示命令使用帮助。

示例

milvus_cli > connect -uri http://127.0.0.1:19530

创建数据库

在 Milvus 中创建数据库

语法

create database -db (text)

选项

选项	全名	说明
-db	-数据库	[必填] Milvus 中的数据库名称。
-帮助	不适用	显示命令使用帮助。

示例

示例 1

下面的示例在 milvus 中创建了数据库testdb 。

milvus_cli > create database -db testdb

使用数据库

在 Milvus 中使用数据库

语法

use database -db (text)

选项

选项	全名	说明
-db	-数据库	[必填] Milvus 中的数据库名称。
-帮助	不适用	显示命令使用帮助。

示例

示例 1

下面的示例使用 milvus 中的数据库testdb 。

milvus_cli > use database -db testdb

列出数据库

列出 Milvus 中的数据库

语法

list databases

示例

示例 1

下面的示例列出了 milvus 中的数据库。

milvus_cli > list databases

删除数据库

删除 Milvus 中的数据库

语法

delete database -db (text)

选项

选项	全名	说明
-db	-数据库	[必填] Milvus 中的数据库名称。
-帮助	不适用	显示命令使用帮助。

示例

示例 1

下面的示例删除了 milvus 中的数据库testdb 。

milvus_cli > delete database -db testdb

创建用户

在 Milvus 中创建用户

语法

create user -u (text) -p (text)

选项

选项	全名	说明
-p	-密码	Milvus 中的用户密码。默认为 "无"。
-u	-用户名	Milvus 中的用户名。默认为 "无"。
-help	不适用	显示命令使用帮助。

示例

示例 1

下面的示例在 milvus 中创建了用户zilliz 和密码zilliz 。

milvus_cli > create user -u zilliz -p zilliz

创建角色

在 Milvus 中创建角色

语法

create role -r (text)

选项

选项	全名	说明
-r	-角色名称	milvus 角色的角色名称。
-帮助	不适用	显示命令使用帮助。

示例

示例 1

下面的示例在 milvus 中创建了角色role1 。

milvus_cli > create role -r role1

创建别名

为 Collections 指定唯一的别名。

语法

create alias -c (text) -a (text) [-A]

选项

选项	全名	说明
-c	-Collection-名称	Collections 的名称。
-a	-别名	别名。
-A	-alter	(可选）将别名转移到指定 Collections 的标志。
-help	不适用	显示命令使用帮助。

示例

示例 1

下面的示例为car Collection 创建了carAlias1 和carAlias2 别名。

milvus_cli > create alias -c car -a carAlias1

例 2

下面的示例将carAlias1 别名从car Collection 转移到car2 Collection。

milvus_cli > create alias -c car2 -A -a carAlias1

创建 Collection

创建一个 Collection。

语法

create collection -c (text) -f (text) -p (text) [-a] [-d (text)]

选项

选项	全名	说明
-c	-Collection-名称	Collections 的名称。
-f	-Schema 字段	(多个）<fieldName>:<dataType>:<dimOfVector/desc> 格式的字段 Schema。
-p	-Schema-主键字段	主键字段的名称。
-a	-Schema-auto-id	(可选）自动生成 ID 的标志。
-desc	-Schema-描述	(可选） Collections 的描述。
-级别	-一致性级别	(可选）一致性级别：有界、会话、强、最终。
-d	-是否动态	(可选） Collections Schema 是否支持动态字段。
-s	-碎片数	(可选）分区编号
-帮助	不适用	显示命令使用帮助。

示例

## For array field: --schema-field support <fieldName>:<dataType>:<maxCapacity>:<elementDataType>(:<maxLength>if Varchar)

milvus_cli > create collection -c car -f id:INT64:primary_field -f vector:FLOAT_VECTOR:128 -f color:INT64:color -f brand:ARRAY:64:VARCHAR:128 -p id -A -d 'car_collection'

创建分区

创建分区。

语法

create partition -c (text) -p (text) [-d (text)]

选项

选项	全名	说明
-c	-Collection-名称	Collections 的名称。
-p	-分区	分区名称。
-d	-分区描述	(可选）分区描述。
-help	不适用	显示命令使用帮助。

示例

milvus_cli > create partition -c car -p new_partition -d test_add_partition

创建索引

为字段创建索引。

语法

create index

选项

选项	全名	说明
-帮助	不适用	显示命令使用帮助。

示例

为字段创建索引并提示输入所需内容：

milvus_cli > create index

Collection name (car, car2): car2

The name of the field to create an index for (vector): vector

Index name: vectorIndex

# Default is ''
Index type FLAT, IVF_FLAT, IVF_SQ8, IVF_PQ, RNSG, HNSW, ANNOY, AUTOINDEX, DISKANN, GPU_IVF_FLAT, GPU_IVF_PQ, SPARSE_INVERTED_INDEX, SPARSE_WAND, SCANN, STL_SORT, Trie, INVERTED, ) []: IVF_FLAT

# Default is ''
Index metric type (L2, IP, HAMMING, TANIMOTO, COSINE, ) []:

Timeout []:

删除用户

删除用户

语法

delete user -u (text)

选项

选项	全名	说明
-u	-用户名	用户名。
-help	不适用	显示命令使用帮助。

示例

milvus_cli > delete user -u zilliz

删除角色

删除 Milvus 中的角色

语法

delete role -r (text)

选项

选项	全名	说明
-r	-角色名称	milvus 角色的角色名称。
-帮助	不适用	显示命令使用帮助。

示例

下面的示例删除了 milvus 中的角色role1 。

milvus_cli > delete role -r role1

删除别名

删除别名。

语法

delete alias -a (text)

选项

选项	全名	说明
-a	-别名	别名。
-帮助	不适用	显示命令使用帮助。

delete Collections

删除一个 Collection。

语法

delete collection -c (text)

选项

选项	全名	说明
-c	-collection-名称	要删除的 Collection 的名称。
-帮助	不适用	显示命令使用帮助。

示例

milvus_cli > delete collection -c car

删除实体

删除实体。

语法

delete entities -c (text) -p (text)

选项

选项	全名	说明
-c	-collection-名称	要删除的实体所属的 Collections 名称。
-p	-分区	(可选）要删除的分区名称。
-help	不适用	显示命令使用帮助。

示例

milvus_cli > delete entities -c car

The expression to specify entities to be deleted, such as "film_id in [ 0, 1 ]": film_id in [ 0, 1 ]

You are trying to delete the entities of collection. This action cannot be undone!

Do you want to continue? [y/N]: y

删除分区

删除分区。

语法

delete partition -c (text) -p (text)

选项

选项	全名	说明
-c	-Collection-名称	要删除的分区所属的 Collections 名称。
-p	-分区	要删除的分区的名称。
-help	不适用	显示命令使用帮助。

示例

milvus_cli > delete partition -c car -p new_partition

删除索引

删除索引和相应的索引文件。

语法

delete index -c (text) -in (text)

选项

选项	全名	说明
-c	-Collection-名称	Collections 的名称。
-在	-索引名称	索引名称。
-帮助	无	显示命令使用帮助。

示例

milvus_cli > delete index -c car -in indexName

授予角色

授予用户角色

语法

选项

选项	全称	说明
-r	-角色名称	milvus 角色的角色名称。
-u	-用户名	milvus 用户的用户名。
-help	不适用	显示命令使用帮助。

示例

grant role -r role1 -u user1

授予权限

为角色分配权限。

语法

选项

选项	全称	说明
-帮助	不适用	显示命令使用帮助。

示例

grant privilege

撤销角色

撤销分配给用户的角色。

语法

选项

选项	全称	说明
-r	-角色名称	milvus 角色的角色名称。
-u	-用户名	milvus 用户的用户名。
-help	不适用	显示命令使用帮助。

示例

grant role -r role1 -u user1

撤销权限

撤销已分配给角色的权限。

语法

选项

选项	全称	说明
-帮助	不适用	显示命令使用帮助。

示例

revoke privilege

show Collections

显示 Collection 的详细信息。

语法

show collection -c (text)

选项

选项	全名	说明
-c	-Collection-名称	Collections 的名称。
-帮助	不适用	显示命令使用帮助。

示例

milvus_cli > show collection -c test_collection_insert

show partition

显示分区的详细信息。

语法

show partition -c (text) -p (text)

选项

选项	全名	说明
-c	-Collection-名称	分区所属 Collections 的名称。
-p	-分区	分区的名称。
-help	不适用	显示命令使用帮助。

示例

milvus_cli > show partition -c test_collection_insert -p _default

show index

显示索引的详细信息。

语法

show index -c (text) -in (text)

选项

选项	全名	说明
-c	-collection-名称	Collections 的名称。
-在	-索引名称	索引名称。

| --help | n/a | 显示命令使用帮助。|

示例

milvus_cli > show index -c test_collection -in index_name

退出

关闭命令行窗口。

语法

exit

选项

选项	全名	说明
-帮助	不适用	显示命令使用帮助。

帮助

显示使用命令的帮助。

语法

help <command>

命令

命令	说明
清除	清除屏幕。
连接	连接 Milvus。
创建	创建 Collections、数据库、分区、用户、角色和索引。
授予	授予角色、权限。
撤销	撤销角色、权限。
删除	删除 Collections、数据库、分区、别名、用户、角色或索引。
退出	关闭命令行窗口。
帮助	显示命令使用帮助。
插入	将数据导入分区。
列表	列出 Collections、数据库、分区、用户、角色、授权或索引。
加载	加载一个 Collection 或分区。
查询	显示符合所有输入条件的查询结果。
释放	释放一个 Collection 或分区。
搜索	执行向量相似性搜索或混合搜索。
显示	显示连接、数据库、Collection、加载进度或索引进度。
重命名	重命名 Collections
使用	使用数据库
版本	显示 Milvus_CLI 的版本。

导入

将本地或远程数据导入分区。

语法

import -c (text)[-p (text)] <file_path>

选项

选项	全名	说明
-c	-collection-名称	插入数据的 Collections 名称。
-p	-分区	(可选）插入数据的分区名称。不通过此分区选项表示选择"_默认 "分区。
-help	不适用	显示命令使用帮助。

示例 1

下面的示例导入了一个本地 CSV 文件。

milvus_cli > import -c car 'examples/import_csv/vectors.csv'

Reading csv file...  [####################################]  100%

Column names are ['vector', 'color', 'brand']

Processed 50001 lines.

Inserting ...

Insert successfully.
--------------------------  ------------------
Total insert entities:                   50000
Total collection entities:              150000
Milvus timestamp:           428849214449254403
--------------------------  ------------------

示例 2

下面的示例导入了一个远程 CSV 文件。

milvus_cli > import -c car 'https://raw.githubusercontent.com/milvus-
io/milvus_cli/main/examples/import_csv/vectors.csv'

Reading file from remote URL.

Reading csv file...  [####################################]  100%

Column names are ['vector', 'color', 'brand']

Processed 50001 lines.

Inserting ...

Insert successfully.

--------------------------  ------------------
Total insert entities:                   50000
Total collection entities:              150000
Milvus timestamp:           428849214449254403
--------------------------  ------------------

列出用户

列出所有用户。

语法

list users

选项

| 选项 | 全名 | 说明 | | --help | n/a | 显示命令使用帮助。|

列出角色

列出 Milvus 中的角色

语法

list roles

选项

选项	全名	说明
-帮助	不适用	显示命令使用帮助。

示例

milvus_cli > list roles

列出拨款

列出 Milvus 中的授权

选项

选项	全称	说明
-r	-角色名称	milvus 角色的角色名称。
-o	-对象名称	milvus 对象的对象名称。
-t	-对象类型	全局、Collection 或用户。
-帮助	不适用	显示命令使用帮助。

示例

milvus_cli > list grants -r role1 -o object1 -t Collection

list Collections

列出所有 Collections。

语法

list collections

选项

选项	全名	说明
-帮助	不适用	显示命令使用帮助。

列出索引

列出 Collections 的所有索引。

语法

list indexes -c (text)

选项

选项	全名	说明
-c	-Collection-名称	Collections 的名称。
-帮助	不适用	显示命令使用帮助。

列出分区

列出 Collections 的所有分区。

语法

list partitions -c (text)

选项

选项	全名	说明
-c	-Collection-名称	Collections 的名称。
-帮助	不适用	显示命令使用帮助。

加载

将一个 Collection 或分区从硬盘空间加载到 RAM。

语法

load -c (text) [-p (text)]

选项

选项	全名	说明
-c	-Collection-名称	分区所属 Collections 的名称。
-p	-分区	(可选/多个）分区的名称。
-help	不适用	显示命令使用帮助。

查询

显示符合所有输入条件的查询结果。

语法

query

选项

选项	全名	说明
-帮助	不适用	显示命令使用帮助。

示例

示例 1

执行查询并提示输入所需内容：

milvus_cli > query

Collection name: car

The query expression: id in [ 428960801420883491, 428960801420883492,
428960801420883493 ]

Name of partitions that contain entities(split by "," if multiple) []:
default

A list of fields to return(split by "," if multiple) []: color, brand

timeout []:

Guarantee timestamp. This instructs Milvus to see all operations performed before a provided timestamp. If no such timestamp is provided, then Milvus will search all operations performed to date. [0]:
Graceful time. Only used in bounded consistency level. If graceful_time is set, PyMilvus will use current timestamp minus the graceful_time as the guarantee_timestamp. This option is 5s by default if not set. [5]:

例 2

执行查询并提示输入所需内容：

milvus_cli > query

Collection name: car

The query expression: id > 428960801420883491

Name of partitions that contain entities(split by "," if multiple) []:
default

A list of fields to return(split by "," if multiple) []: id, color,
brand

timeout []:

Guarantee timestamp. This instructs Milvus to see all operations performed before a provided timestamp. If no such timestamp is provided, then Milvus will search all operations performed to date. [0]:
Graceful time. Only used in bounded consistency level. If graceful_time is set, PyMilvus will use current timestamp minus the graceful_time as the guarantee_timestamp. This option is 5s by default if not set. [5]:

释放

从 RAM 中释放一个 Collection 或分区。

语法

release -c (text) [-p (text)]

选项

选项	全名	说明
-c	-Collection-名称	分区所属 Collections 的名称。
-p	-分区	(可选/多个）分区的名称。
-help	不适用	显示命令使用帮助。

搜索

执行向量相似性搜索或混合搜索。

语法

search

选项

选项	全称	说明
-帮助	不适用	显示命令使用帮助。

示例

示例 1

对 csv 文件执行搜索，并提示输入所需内容：

milvus_cli > search

Collection name (car, test_collection): car

The vectors of search data(the length of data is number of query (nq), the dim of every vector in data must be equal to vector field’s of collection. You can also import a csv file
out headers): examples/import_csv/search_vectors.csv

The vector field used to search of collection (vector): vector

Search parameter nprobe's value: 10

The max number of returned record, also known as topk: 2

The boolean expression used to filter attribute []: id > 0

The names of partitions to search (split by "," if multiple) ['_default'] []: _default

timeout []:

Guarantee Timestamp(It instructs Milvus to see all operations performed before a provided timestamp. If no such timestamp is provided, then Milvus will search all operations performed to date) [0]:

例 2

对索引 Collections 执行搜索，并提示输入所需内容：

milvus_cli > search

Collection name (car, test_collection): car

The vectors of search data(the length of data is number of query (nq), the dim of every vector in data must be equal to vector field’s of collection. You can also import a csv file without headers):
    [[0.71, 0.76, 0.17, 0.13, 0.42, 0.07, 0.15, 0.67, 0.58, 0.02, 0.39, 0.47, 0.58, 0.88, 0.73, 0.31, 0.23, 0.57, 0.33, 0.2, 0.03, 0.43, 0.78, 0.49, 0.17, 0.56, 0.76, 0.54, 0.45, 0.46, 0.05, 0.1, 0.43, 0.63, 0.29, 0.44, 0.65, 0.01, 0.35, 0.46, 0.66, 0.7, 0.88, 0.07, 0.49, 0.92, 0.57, 0.5, 0.16, 0.77, 0.98, 0.1, 0.44, 0.88, 0.82, 0.16, 0.67, 0.63, 0.57, 0.55, 0.95, 0.13, 0.64, 0.43, 0.71, 0.81, 0.43, 0.65, 0.76, 0.7, 0.05, 0.24, 0.03, 0.9, 0.46, 0.28, 0.92, 0.25, 0.97, 0.79, 0.73, 0.97, 0.49, 0.28, 0.64, 0.19, 0.23, 0.51, 0.09, 0.1, 0.53, 0.03, 0.23, 0.94, 0.87, 0.14, 0.42, 0.82, 0.91, 0.11, 0.91, 0.37, 0.26, 0.6, 0.89, 0.6, 0.32, 0.11, 0.98, 0.67, 0.12, 0.66, 0.47, 0.02, 0.15, 0.6, 0.64, 0.57, 0.14, 0.81, 0.75, 0.11, 0.49, 0.78, 0.16, 0.63, 0.57, 0.18]]

The vector field used to search of collection (vector): vector

Search parameter nprobe's value: 10

The specified number of decimal places of returned distance [-1]: 5

The max number of returned record, also known as topk: 2

The boolean expression used to filter attribute []: id > 0

The names of partitions to search (split by "," if multiple) ['_default'] []: _default

timeout []:

Guarantee Timestamp(It instructs Milvus to see all operations performed before a provided timestamp. If no such timestamp is provided, then Milvus will search all operations performed to date) [0]:

例 3

在非索引 Collections 上执行搜索，并提示输入所需内容：

milvus_cli > search

Collection name (car, car2): car

The vectors of search data(the length of data is number of query (nq), the dim of every vector in data must be equal to vector field’s of collection. You can also import a csv file without headers): examples/import_csv/search_vectors.csv

The vector field used to search of collection (vector): vector

The specified number of decimal places of returned distance [-1]: 5

The max number of returned record, also known as topk: 2

The boolean expression used to filter attribute []:

The names of partitions to search (split by "," if multiple) ['_default'] []:

timeout []:

Guarantee Timestamp(It instructs Milvus to see all operations performed before a provided timestamp. If no such timestamp is provided, then Milvus will search all operations performed to date) [0]:

列出连接

列出连接。

语法

list connections

选项

选项	全名	说明
-帮助	不适用	显示命令使用帮助。

show index_progress

显示实体索引的进度。

语法

show index_progress -c (text) [-i (text)]

选项

选项	全名	说明
-c	-Collection-名称	实体所属 Collections 的名称。
-i	-索引	(可选）索引名称。
-help	不适用	显示命令使用帮助。

显示加载进度

显示 Collections 的加载进度。

语法

show loading_progress -c (text) [-p (text)]

选项

选项	全称	说明
-c	-Collection-名称	实体所属 Collections 的名称。
-p	-分区	(可选/多个）加载分区的名称。
-help	不适用	显示命令使用帮助。

版本

显示 Milvus_CLI 的版本。

语法

version

选项

选项	全称	说明
-帮助	不适用	显示命令使用帮助。

示例

$ milvus_cli --version
Milvus_CLI v0.4.0