Milvus_CLI 명령 참조

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

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

명령 그룹

Milvus CLI 명령은 다음과 같은 그룹으로 구성되어 있습니다:

• create: 컬렉션, 데이터베이스, 파티션, 사용자, 역할 또는 인덱스 생성
• delete: 컬렉션, 데이터베이스, 파티션, 별칭, 사용자, 역할 또는 인덱스 삭제
• list: 컬렉션, 데이터베이스, 파티션, 사용자, 역할, 부여 또는 인덱스 나열
• show: 연결, 데이터베이스, 컬렉션, 로딩_진행률 또는 인덱스_진행률 표시
• grant: 역할 또는 권한 부여
• revoke: 역할 또는 권한 취소
• load: 로드 컬렉션 또는 파티션
• release: 컬렉션 또는 파티션 해제
• use: 데이터베이스 사용
• rename: 컬렉션 이름 바꾸기
• insert: 엔티티(파일 또는 행) 삽입

clear

화면을 지웁니다.

구문

clear

옵션

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

connect

밀버스에 연결합니다.

구문

connect [-uri (text)] [-t (text)]
connect [-uri (text)] [-t (text)] [-tls (0|1)] [-cert (text)]

옵션

옵션	전체 이름	설명
-uri	-uri	(선택 사항) URL 이름입니다. 기본값은 "http://127.0.0.1:19530"입니다.
-t	-토큰	(선택 사항) zilliz 클라우드 아피키 또는 username:password. 기본값은 없음입니다.
-tls	-tlsmode	(선택 사항) TLS 모드를 설정합니다: 0(암호화 안 함), 1(단방향 암호화), 2(양방향 암호화 아직 지원 안 함). 기본값은 0입니다.
-cert	-cert	(선택 사항) 클라이언트 인증서 파일의 경로입니다. 단방향 암호화로 작업하기
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제

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

데이터베이스 만들기

Milvus에서 데이터베이스 만들기

구문

create database -db (text)

옵션

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

예제

예제 1

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

milvus_cli > create database -db testdb

데이터베이스 사용

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

구문

use database -db (text)

옵션

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

예제

예제 1

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

milvus_cli > use database -db testdb

데이터베이스 목록

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

구문

list databases

예제

예제 1

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

milvus_cli > list databases

데이터베이스 삭제

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

구문

delete database -db (text)

옵션

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

예제

예제 1

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

milvus_cli > delete database -db testdb

Warning! You are trying to delete the database. This action cannot be undone!
Do you want to continue? [y/N]: y

사용자 만들기

밀버스에서 사용자 만들기

구문

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

대화형 예

milvus_cli > create collection

Please input collection name: car
Please input auto id [False]: False
Please input description []: car collection
Is support dynamic field [False]: False
Please input consistency level(Strong(0),Bounded(1), Session(2), and Eventually(3)) [1]: 1
Please input shards number [1]: 1

Field name: id
Field type (INT64, VARCHAR, FLOAT_VECTOR, etc.): INT64
Field description []: primary key
Is id the primary key? [y/N]: y

Field name: vector
Field type (INT64, VARCHAR, FLOAT_VECTOR, etc.): FLOAT_VECTOR
Field description []: vector field
Dimension: 128

Field name: color
Field type (INT64, VARCHAR, FLOAT_VECTOR, etc.): INT64
Field description []: color field
Nullable [False]: False
Default value (type: INT64) [Not set]: 0

Do you want to add embedding function? [y/N]: n

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

대화형 예제

milvus_cli > create index

Collection name (car, car2): car2
The name of the field to create an index for (vector): vector
Index name: vectorIndex
Index type (FLAT, IVF_FLAT, IVF_SQ8, IVF_PQ, RNSG, HNSW, ANNOY, AUTOINDEX, DISKANN, GPU_IVF_FLAT, GPU_IVF_PQ, SPARSE_INVERTED_INDEX, SCANN, STL_SORT, Trie, INVERTED): IVF_FLAT
Vector Index metric type (L2, IP, HAMMING, TANIMOTO, COSINE): L2
Index params nlist: 2
Timeout []:

delete user

사용자를 삭제합니다.

구문

delete user -u (text)

옵션

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

예제

milvus_cli > delete user -u zilliz

Warning! You are trying to delete the user in milvus. This action cannot be undone!
Do you want to continue? [y/N]: y

삭제 역할

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

Warning! You are trying to delete the collection. This action cannot be undone!
Do you want to continue? [y/N]: y

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 ]

Warning! 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

Warning! You are trying to delete the index of collection. This action cannot be undone!
Do you want to continue? [y/N]: y

부여 역할

사용자에게 역할 부여

구문

grant role -r (text) -u (text)

옵션

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

예제

milvus_cli > grant role -r role1 -u user1

부여 권한

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

구문

grant privilege

대화형 예

milvus_cli > grant privilege

Role name: role1
The type of object for which the privilege is to be assigned. (Global, Collection, User): Collection
The name of the object to control access for: object1
The name of the privilege to assign. (CreateCollection, DropCollection, etc.): CreateCollection
The name of the database to which the object belongs. [default]: default

역할 해지

사용자에게 할당된 역할을 해지합니다.

구문

revoke role -r (text) -u (text)

옵션

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

예제

milvus_cli > revoke role -r role1 -u user1

revoke privilege

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

구문

revoke privilege

대화형 예

milvus_cli > revoke privilege

Role name: role1
The type of object for which the privilege is to be assigned. (Global, Collection, User): Collection
The name of the object to control access for: object1
The name of the privilege to assign. (CreateCollection, DropCollection, etc.): CreateCollection
The name of the database to which the object belongs. [default]: default

컬렉션 표시

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

구문

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의 버전을 표시합니다.

삽입

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

구문

insert file -c (text) [-p (text)] [-t (text)] <file_path>

옵션

옵션	전체 이름	설명
-c	-컬렉션 이름	데이터가 삽입되는 컬렉션의 이름입니다.
-p	-partition	(선택 사항) 데이터를 삽입할 파티션의 이름입니다. 이 파티션 옵션을 전달하지 않으면 "_기본" 파티션을 선택하게 됩니다.
-t	-타임아웃	(선택 사항) RPC를 허용할 시간(초)(선택 사항)입니다. 시간 제한을 설정하지 않으면 클라이언트는 서버가 응답하거나 오류가 발생할 때까지 계속 대기합니다.
-help	n/a	명령 사용에 대한 도움말을 표시합니다.

예제 1

다음 예는 로컬 CSV 파일을 가져옵니다.

milvus_cli > insert file -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 > insert file -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
--------------------------  ------------------

insert row

컬렉션에 데이터 행을 삽입합니다.

구문

insert row

대화형 예제

milvus_cli > insert row

Collection name: car
Partition name [_default]: _default
Enter value for id (INT64): 1
Enter value for vector (FLOAT_VECTOR): [1.0, 2.0, 3.0]
Enter value for color (INT64): 100
Enter value for brand (VARCHAR): Toyota

Inserted successfully.

사용자 목록

모든 사용자를 나열합니다.

구문

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 collection -c (text) [-p (text)]

옵션

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

쿼리

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

구문

query

대화형 예제

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

release

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

구문

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

옵션

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

검색

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

구문

search

대화형 예제

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

연결 목록

연결을 나열합니다.

구문

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