milvus-logo
LFAI
首页
  • 工具

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 指定唯一的别名。

一个 Collection 可以有多个别名。不过,一个别名最多对应一个 Collection。

语法

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

选项

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

示例

示例 1

下面的示例为car Collection 创建了carAlias1carAlias2 别名。

milvus_cli > create alias -c car -a carAlias1

例 2

例 2 基于例 1。

下面的示例将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

创建索引

为字段创建索引。

目前,一个 Collection 最多支持一个索引。

语法

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

删除索引

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

目前,一个 Collection 最多支持一个索引。

语法

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 的所有索引。

目前,一个 Collection 最多支持一个索引。

语法

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

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

对 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]:

对索引 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]:

在非索引 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

选项

选项全称说明
-帮助不适用显示命令使用帮助。
也可以在 shell 中检查 Milvus_CLI 的版本,如下例所示。在这种情况下,milvus_cli --version 充当命令。

示例

$ milvus_cli --version
Milvus_CLI v0.4.0