Milvus_CLI 명령 참조

Milvus CLI(명령줄 인터페이스)는 데이터베이스 연결, 데이터 작업, 데이터 가져오기 및 내보내기를 지원하는 명령줄 도구입니다.

이 항목에서는 지원되는 모든 명령어와 해당 옵션을 소개합니다. 참조를 위해 몇 가지 예제도 포함되어 있습니다.

clear

화면을 지웁니다.

구문

clear

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

connect

밀버스에 연결합니다.

구문

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

옵션

옵션	전체 이름	설명
-uri	-uri	(선택 사항) URL 이름입니다. 기본값은 "http://127.0.0.1:19530"입니다.
-t	-토큰	(선택 사항) zilliz 클라우드 아피키 또는 username:password. 기본값은 없음입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

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

데이터베이스 생성

밀버스에서 데이터베이스 만들기

구문

create database -db (text)

옵션

옵션	전체 이름	설명
-db	-database	[필수] 밀버스 단위의 데이터베이스 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

예제 1

다음 예제에서는 밀버스에서 testdb 데이터베이스를 만듭니다.

milvus_cli > create database -db testdb

데이터베이스 사용

밀버스에서 데이터베이스 사용

구문

use database -db (text)

옵션

옵션	전체 이름	설명
-db	-database	[필수] 밀버스 단위의 데이터베이스 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

예제 1

다음 예에서는 밀버스에서 testdb 데이터베이스를 사용합니다.

milvus_cli > use database -db testdb

데이터베이스 목록

밀버스에서 데이터베이스 나열

구문

list databases

예제

예제 1

다음 예제는 밀버스로 데이터베이스를 나열합니다.

milvus_cli > list databases

데이터베이스 삭제

밀버스에서 데이터베이스 삭제

구문

delete database -db (text)

옵션

옵션	전체 이름	설명
-db	-database	[필수] 밀버스 단위의 데이터베이스 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

예제 1

다음 예제는 밀버스에서 testdb 데이터베이스를 삭제합니다.

milvus_cli > delete database -db testdb

사용자 만들기

밀버스에서 사용자 만들기

구문

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

옵션

옵션	전체 이름	설명
-p	-password	밀버스 단위의 사용자 비밀번호입니다. 기본값은 "없음"입니다.
-u	-username	밀버스 단위의 사용자 이름입니다. 기본값은 "없음"입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

예제 1

다음 예에서는 밀버스에서 zilliz 사용자 및 zilliz 비밀번호를 만듭니다.

milvus_cli > create user -u zilliz -p zilliz

역할 만들기

밀버스에서 역할 만들기

구문

create role -r (text)

옵션

옵션	전체 이름	설명
-r	-역할 이름	밀버스 역할의 역할 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

예제 1

다음 예에서는 밀버스에서 role1 역할을 만듭니다.

milvus_cli > create role -r role1

별칭 만들기

컬렉션의 고유한 별칭을 지정합니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	컬렉션의 이름입니다.
-a	-별칭 이름	별칭입니다.
-A	-alter	(선택 사항) 별칭을 지정된 컬렉션으로 전송하려면 플래그를 지정합니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

예제 1

다음 예에서는 car 컬렉션에 대한 carAlias1 및 carAlias2 별칭을 만듭니다.

milvus_cli > create alias -c car -a carAlias1

예 2

다음 예는 car 컬렉션에서 car2 컬렉션으로 carAlias1 별칭을 전송하는 예제입니다.

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

컬렉션 만들기

컬렉션을 만듭니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	컬렉션의 이름입니다.
-f	-schema-field	(복수) <fieldName>:<dataType>:<dimOfVector/desc> 형식의 필드 스키마입니다.
-p	-schema-primary-field	기본 키 필드의 이름입니다.
-a	-schema-auto-id	(선택 사항) ID를 자동으로 생성하도록 플래그합니다.
-desc	-schema-description	(선택 사항) 컬렉션에 대한 설명.
-level	-정합성 수준	(선택 사항) 일관성 수준: 바운드, 세션, 강력, 최종 .
-d	-is-dynamic	(선택 사항) 컬렉션 스키마가 동적 필드를 지원하는지 여부.
-s	-shards-num	(선택 사항) 샤드 번호
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

## 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

파티션을 만듭니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	컬렉션의 이름입니다.
-p	-partition	파티션 이름입니다.
-d	-description	(선택 사항) 파티션에 대한 설명입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

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

create index

필드에 대한 인덱스를 만듭니다.

구문

create index

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

필드에 대한 인덱스를 생성하고 필요한 입력을 묻는 메시지를 표시합니다:

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

사용자를 삭제합니다.

구문

delete user -u (text)

옵션

옵션	전체 이름	설명
-u	-사용자 이름	사용자 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

milvus_cli > delete user -u zilliz

삭제 역할

Milvus에서 역할 삭제

구문

delete role -r (text)

옵션

옵션	전체 이름	설명
-r	-역할 이름	밀버스 역할의 역할 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

다음 예는 밀버스에서 role1 역할을 삭제합니다.

milvus_cli > delete role -r role1

별칭 삭제

별칭을 삭제합니다.

구문

delete alias -a (text)

옵션

옵션	전체 이름	설명
-a	-별칭 이름	별칭입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

컬렉션 삭제

컬렉션을 삭제합니다.

구문

delete collection -c (text)

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	삭제할 컬렉션의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

milvus_cli > delete collection -c car

delete entities

엔티티를 삭제합니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	삭제할 엔터티가 속한 컬렉션의 이름입니다.
-p	-partition	(선택 사항) 삭제할 파티션의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

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	-컬렉션 이름	삭제할 파티션이 속한 컬렉션의 이름입니다.
-p	-partition	삭제할 파티션의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

milvus_cli > delete partition -c car -p new_partition

삭제 인덱스

인덱스와 해당 인덱스 파일을 삭제합니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	컬렉션의 이름입니다.
-in	-인덱스 이름	인덱스 이름의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

milvus_cli > delete index -c car -in indexName

부여 역할

사용자에게 역할 부여

구문

옵션

옵션	전체 이름	설명
-r	-역할 이름	밀버스 역할의 역할 이름입니다.
-u	-사용자 이름	밀버스 사용자의 사용자 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

grant role -r role1 -u user1

부여 권한

역할에 권한을 할당합니다.

구문

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

grant privilege

revoke role

사용자에게 할당된 역할을 취소합니다.

구문

옵션

옵션	전체 이름	설명
-r	-역할 이름	밀버스 역할의 역할 이름입니다.
-u	-사용자 이름	밀버스 사용자의 사용자 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

grant role -r role1 -u user1

revoke privilege

역할에 이미 할당된 권한을 취소합니다.

구문

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

revoke privilege

show collection

컬렉션의 상세 정보를 표시합니다.

구문

show collection -c (text)

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	컬렉션의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

milvus_cli > show collection -c test_collection_insert

show partition

파티션의 자세한 정보를 표시합니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	파티션이 속한 컬렉션의 이름입니다.
-p	-partition	파티션의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

milvus_cli > show partition -c test_collection_insert -p _default

show index

인덱스의 상세 정보를 표시합니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	컬렉션의 이름입니다.
-in	-인덱스 이름	인덱스의 이름입니다.

| --help | n/a | 명령 사용에 대한 도움말을 표시합니다. |

예제

milvus_cli > show index -c test_collection -in index_name

exit

명령줄 창을 닫습니다.

구문

exit

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

help

명령 사용에 대한 도움말을 표시합니다.

구문

help <command>

명령

명령	설명
clear	화면을 지웁니다.
연결	밀버스에 연결합니다.
create	컬렉션, 데이터베이스, 파티션, 사용자, 역할 및 인덱스를 생성합니다.
부여	역할, 권한을 부여합니다.
revoke	역할, 권한을 취소합니다.
삭제	컬렉션, 데이터베이스, 파티션, 별칭, 사용자, 역할 또는 인덱스를 삭제합니다.
exit	명령줄 창을 닫습니다.
도움말	명령 사용에 대한 도움말을 표시합니다.
insert	데이터를 파티션으로 가져옵니다.
목록	컬렉션, 데이터베이스, 파티션, 사용자, 역할, 권한 또는 인덱스를 나열합니다.
load	컬렉션 또는 파티션을 로드합니다.
쿼리	입력한 모든 조건과 일치하는 쿼리 결과를 표시합니다.
release	컬렉션 또는 파티션을 해제합니다.
검색	벡터 유사도 검색 또는 하이브리드 검색을 수행합니다.
show	연결, 데이터베이스, 컬렉션, 로딩 진행률 또는 인덱스 진행률을 표시합니다.
이름 바꾸기	컬렉션 이름 바꾸기
사용	데이터베이스 사용
버전	Milvus_CLI의 버전을 표시합니다.

가져오기

로컬 또는 원격 데이터를 파티션으로 가져옵니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	데이터가 삽입되는 컬렉션의 이름입니다.
-p	-partition	(선택 사항) 데이터를 삽입할 파티션의 이름입니다. 이 파티션 옵션을 전달하지 않으면 "_기본" 파티션을 선택합니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제 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 | 명령 사용에 대한 도움말을 표시합니다. |

역할 나열

밀버스에서 역할 나열

구문

list roles

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

milvus_cli > list roles

보조금 목록

밀버스에서 보조금을 나열합니다.

옵션

옵션	전체 이름	설명
-r	-역할 이름	밀버스 역할의 역할 이름입니다.
-o	-objectName	밀버스 오브젝트의 오브젝트 이름입니다.
-t	-objectType	전역, 컬렉션 또는 사용자.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

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

목록 컬렉션

모든 컬렉션을 나열합니다.

구문

list collections

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

인덱스 목록

컬렉션의 모든 인덱스를 나열합니다.

구문

list indexes -c (text)

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	컬렉션의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

파티션 목록

컬렉션의 모든 파티션을 나열합니다.

구문

list partitions -c (text)

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	컬렉션의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

load

컬렉션 또는 파티션을 하드 드라이브 공간에서 RAM으로 로드합니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	파티션이 속한 컬렉션의 이름입니다.
-p	-partition	(선택 사항/복수) 파티션의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

쿼리

입력한 모든 조건과 일치하는 쿼리 결과를 표시합니다.

구문

query

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

예제 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]:

release

컬렉션 또는 파티션을 RAM에서 해제합니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	파티션이 속한 컬렉션의 이름입니다.
-p	-partition	(선택 사항/복수) 파티션의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

검색

벡터 유사도 검색 또는 하이브리드 검색을 수행합니다.

구문

search

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

예제 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

색인된 컬렉션에서 검색을 수행하고 필요한 입력을 묻는 메시지를 표시하려면 다음과 같이 하세요:

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

색인되지 않은 컬렉션에서 검색을 수행하고 필요한 입력을 묻는 메시지를 표시하려면 다음과 같이 하세요:

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

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

show index_progress

엔티티 인덱싱의 진행 상황을 표시합니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	엔티티가 속한 컬렉션의 이름입니다.
-i	-index	(선택 사항) 인덱스의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

show loading_progress

컬렉션 로딩 진행률을 표시합니다.

구문

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

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	엔티티가 속한 컬렉션의 이름입니다.
-p	-partition	(선택 사항/복수) 로딩 파티션의 이름입니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

version

Milvus_CLI의 버전을 표시합니다.

구문

version

옵션

옵션	전체 이름	설명
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

$ milvus_cli --version
Milvus_CLI v0.4.0