Referencia de comandos Milvus_CLI

La interfaz de línea de comandos (CLI) de Milvus es una herramienta de línea de comandos que soporta la conexión a bases de datos, operaciones de datos e importación y exportación de datos.

Este tema presenta todos los comandos soportados y las opciones correspondientes. También se incluyen algunos ejemplos para su referencia.

Grupos de comandos

Los comandos CLI de Milvus están organizados en los siguientes grupos:

• create: Crear colección, base de datos, partición, usuario, función o índice
• delete: Eliminar colección, base de datos, partición, alias, usuario, función o índice
• list: Listar colecciones, bases de datos, particiones, usuarios, roles, concesiones o índices
• show: Mostrar conexión, base de datos, colección, progreso_carga o progreso_índice
• grant: Conceder rol o privilegio
• revoke: Revocar función o privilegio
• load: Cargar colección o partición
• release: Liberar colección o partición
• use: Utilizar base de datos
• rename: Renombrar colección
• insert: Insertar entidades (fichero o fila)

borrar

Borra la pantalla.

Sintaxis

clear

Opciones

Opción	Nombre completo	Descripción
-help	n/a	Muestra la ayuda para utilizar el comando.

conectar

Conecta con Milvus.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-uri	-uri	(Opcional) El nombre uri. Por defecto es "http://127.0.0.1:19530".
-t	-token	(Opcional) El apikey de la nube zilliz o username:password. El valor predeterminado es Ninguno.
-tls	-tlsmode	(Opcional) Establece el modo TLS: 0 (Sin encriptación), 1 (Encriptación unidireccional), 2 (Encriptación bidireccional no soportada aún). Por defecto es 0
-cert	-cert	(Opcional) Ruta al archivo del certificado del cliente. Trabaja con cifrado unidireccional
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

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

crear Base de Datos

Crear Base de Datos en Milvus

Sintaxis

create database -db (text)

Opciones

Opción	Nombre completo	Descripción
-db	-nombre_db	[Obligatorio] El nombre de la base de datos en milvus.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplos

Ejemplo 1

El siguiente ejemplo crea la base de datos testdb en milvus.

milvus_cli > create database -db testdb

use Base de datos

Utilizar base de datos en Milvus

Sintaxis

use database -db (text)

Opciones

Opción	Nombre completo	Descripción
-db	-nombre_db	[Obligatorio] El nombre de la base de datos en milvus.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplos

Ejemplo 1

El siguiente ejemplo utiliza la base de datos testdb en milvus.

milvus_cli > use database -db testdb

list Bases de datos

Listar bases de datos en Milvus

Sintaxis

list databases

Ejemplos

Ejemplo 1

El siguiente ejemplo lista las bases de datos en milvus.

milvus_cli > list databases

delete Base de Datos

Borrar Base de Datos en Milvus

Sintaxis

delete database -db (text)

Opciones

Opción	Nombre completo	Descripción
-db	-nombre_db	[Obligatorio] El nombre de la base de datos en milvus.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplos

Ejemplo 1

El siguiente ejemplo elimina la base de datos testdb en milvus.

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

crear usuario

Crear usuario en Milvus

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-p	-contraseña	La contraseña del usuario en milvus. Por defecto es "None".
-u	-nombre de usuario	El nombre de usuario en milvus. Por defecto es "Ninguno".
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplos

Ejemplo 1

El siguiente ejemplo crea el usuario zilliz y la contraseña zilliz en milvus.

milvus_cli > create user -u zilliz -p zilliz

crear rol

Crear rol en Milvus

Sintaxis

create role -r (text)

Opciones

Opción	Nombre completo	Descripción
-r	-roleName	El nombre del rol de milvus.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplos

Ejemplo 1

El siguiente ejemplo crea el rol role1 en milvus.

milvus_cli > create role -r role1

crear alias

Especifica alias únicos para una colección.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-Nombre de la colección	El nombre de la colección.
-a	-alias-nombre	El alias.
-A	-alter	(Opcional) Bandera para transferir el alias a una colección especificada.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplos

Ejemplo 1

El siguiente ejemplo crea los alias carAlias1 y carAlias2 para la colección car.

milvus_cli > create alias -c car -a carAlias1

Ejemplo 2

El siguiente ejemplo transfiere el alias carAlias1 de la colección car a la colección car2.

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

crear colección

Crea una colección.

Sintaxis

create collection

Ejemplo interactivo

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

crear partición

Crea una partición.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-Nombre de la colección	El nombre de la colección.
-p	-partición	El nombre de la partición.
-d	-description	(Opcional) La descripción de la partición.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

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

crear índice

Crea un índice para un campo.

Sintaxis

create index

Interactivo Ejemplo

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

eliminar usuario

Elimina un usuario

Sintaxis

delete user -u (text)

Opciones

Opción	Nombre completo	Descripción
-u	-Nombre de usuario	El nombre de usuario.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

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

borrar rol

Borrar rol en Milvus

Sintaxis

delete role -r (text)

Opciones

Opción	Nombre completo	Descripción
-r	-roleName	El nombre del rol de milvus.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplos

El siguiente ejemplo elimina el rol role1 en milvus.

milvus_cli > delete role -r role1

eliminar alias

Elimina un alias.

Sintaxis

delete alias -a (text)

Opciones

Opción	Nombre completo	Descripción
-a	-nombre-del-alias	El alias.
-help	n/a	Muestra la ayuda para utilizar el comando.

eliminar colección

Elimina una colección.

Sintaxis

delete collection -c (text)

Opciones

Opción	Nombre completo	Descripción
-c	-nombre-de-la-colección	El nombre de la colección que se va a eliminar.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

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

borrar entidades

Elimina las entidades.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-nombre-de-la-colección	El nombre de la colección a la que pertenecen las entidades que se van a eliminar.
-p	-partición	(Opcional) El nombre de la partición que se va a eliminar.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

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

borrar partición

Elimina una partición.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-nombre-de-la-colección	El nombre de la colección a la que pertenece la partición a borrar.
-p	-partición	El nombre de la partición a borrar.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

milvus_cli > delete partition -c car -p new_partition

borrar índice

Elimina un índice y los archivos de índice correspondientes.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-Nombre de la colección	El nombre de la colección.
-en	-nombre-índice	El nombre del índice.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

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

otorgar rol

Conceder rol al usuario

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-r	-roleName	El nombre del rol de milvus.
-u	-nombredeusuario	El nombre de usuario de milvus.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

milvus_cli > grant role -r role1 -u user1

otorgar privilegio

Asigna un privilegio a un rol.

Sintaxis

grant privilege

Interactivo Ejemplo

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

revocar rol

Revoca el rol asignado a un usuario.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-r	-roleName	El nombre del rol de milvus.
-u	-nombredeusuario	El nombre de usuario de milvus.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

milvus_cli > revoke role -r role1 -u user1

revocar privilegio

Revoca un privilegio ya asignado a un rol.

Sintaxis

revoke privilege

Interactivo Ejemplo

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

mostrar colección

Muestra la información detallada de una colección.

Sintaxis

show collection -c (text)

Opciones

Opción	Nombre completo	Descripción
-c	-Nombre de la colección	El nombre de la colección.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

milvus_cli > show collection -c test_collection_insert

mostrar partición

Muestra la información detallada de una partición.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-nombre-de-la-colección	El nombre de la colección a la que pertenece la partición.
-p	-partición	El nombre de la partición.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

milvus_cli > show partition -c test_collection_insert -p _default

mostrar índice

Muestra la información detallada de un índice.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-Nombre de la colección	El nombre de la colección.
-en	-nombre-índice	El nombre del índice.

| --help | n/a | Muestra la ayuda para utilizar el comando. |

Ejemplo

milvus_cli > show index -c test_collection -in index_name

salir

Cierra la ventana de la línea de comandos.

Sintaxis

exit

Opciones

Opción	Nombre completo	Descripción
-help	n/a	Muestra ayuda para utilizar el comando.

ayuda

Muestra la ayuda para utilizar un comando.

Sintaxis

help <command>

Comandos

Comando	Descripción
borrar	Borra la pantalla.
conectar	Se conecta a Milvus.
crear	Crea colección, base de datos, partición, usuario, rol e índice.
conceder	Conceder rol, privilegio .
revocar	Revocar rol, privilegio .
borrar	Borrar colección, base de datos, partición, alias, usuario, rol o índice.
salir	Cierra la ventana de línea de comandos.
ayuda	Muestra la ayuda para utilizar un comando.
insertar	Importa datos a una partición.
list	Lista colecciones, bases de datos, particiones, usuarios, roles, concesiones o índices.
cargar	Carga una colección o partición.
consulta	Muestra los resultados de la consulta que coinciden con los criterios introducidos.
liberar	Libera una colección o partición.
buscar	Realiza una búsqueda de similitud vectorial o una búsqueda híbrida.
mostrar	Muestra la conexión, la base de datos, la colección, el progreso de carga o el progreso del índice.
renombrar	Renombra la colección
utilizar	Usar base de datos
versión	Muestra la versión de Milvus_CLI.

insertar

Importa datos locales o remotos a una partición.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-Nombre de la colección	El nombre de la colección en la que se insertan los datos.
-p	-partición	(Opcional) El nombre de la partición en la que se insertan los datos. Si no se pasa esta opción de partición, se elige la partición "_por defecto".
-t	-timeout	(Opcional) Una duración opcional de tiempo en segundos para permitir la RPC. Si no se establece el tiempo de espera, el cliente seguirá esperando hasta que el servidor responda o se produzca un error.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo 1

El siguiente ejemplo importa un archivo CSV local.

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

Ejemplo 2

El siguiente ejemplo importa un archivo CSV remoto.

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

insertar fila

Inserta una fila de datos en una colección.

Sintaxis

insert row

Ejemplo interactivo

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.

listar usuarios

Lista todos los usuarios.

Sintaxis

list users

Opciones

| Opción | Nombre completo | Descripción | | --help | n/a | Muestra ayuda para usar el comando. |

Listar roles

Listar roles en Milvus

Sintaxis

list roles

Opciones

Opción	Nombre completo	Descripción
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplos

milvus_cli > list roles

Listar subvenciones

Listar subvenciones en Milvus

Opciones

Opción	Nombre completo	Descripción
-r	-roleName	El nombre del rol de milvus.
-o	-objectName	El nombre del objeto de milvus.
-t	-Tipo de objeto	Global, Colección o Usuario.
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplos

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

listar colecciones

Lista todas las colecciones.

Sintaxis

list collections

Opciones

Opción	Nombre completo	Descripción
-help	n/a	Muestra la ayuda para utilizar el comando.

listar índices

Lista todos los índices de una colección.

Sintaxis

list indexes -c (text)

Opciones

Opción	Nombre completo	Descripción
-c	-Nombre de la colección	El nombre de la colección.
-help	n/a	Muestra la ayuda para utilizar el comando.

listar particiones

Lista todas las particiones de una colección.

Sintaxis

list partitions -c (text)

Opciones

Opción	Nombre completo	Descripción
-c	-Nombre de la colección	El nombre de la colección.
-help	n/a	Muestra la ayuda para utilizar el comando.

cargar

Carga una colección o partición desde el disco duro a la memoria RAM.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-nombre-de-la-colección	El nombre de la colección a la que pertenece la partición.
-p	-partición	(Opcional/Múltiple) El nombre de la partición.
-help	n/a	Muestra la ayuda para utilizar el comando.

consulta

Muestra los resultados de la consulta que coinciden con todos los criterios introducidos.

Sintaxis

query

Interactivo Ejemplo

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

liberar

Libera una colección o partición de la RAM.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-nombre-de-la-colección	El nombre de la colección a la que pertenece la partición.
-p	-partición	(Opcional/Múltiple) El nombre de la partición.
-help	n/a	Muestra la ayuda para utilizar el comando.

búsqueda

Realiza una búsqueda de similitud vectorial o una búsqueda híbrida.

Sintaxis

search

Ejemplo interactivo

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

listar conexión

Lista las conexiones.

Sintaxis

list connections

Opciones

Opción	Nombre completo	Descripción
-help	n/a	Muestra la ayuda para utilizar el comando.

show index_progress

Muestra el progreso de la indexación de entidades.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-nombre-de-la-colección	El nombre de la colección a la que pertenecen las entidades.
-i	-index	(Opcional) El nombre del índice.
-help	n/a	Muestra la ayuda para utilizar el comando.

mostrar_progreso_carga

Muestra el progreso de carga de una colección.

Sintaxis

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

Opciones

Opción	Nombre completo	Descripción
-c	-nombre-de-la-colección	El nombre de la colección a la que pertenecen las entidades.
-p	-partición	(Opcional/Múltiple) El nombre de la partición de carga.
-help	n/a	Muestra la ayuda para utilizar el comando.

versión

Muestra la versión de Milvus_CLI.

Sintaxis

version

Opciones

Opción	Nombre completo	Descripción
-help	n/a	Muestra la ayuda para utilizar el comando.

Ejemplo

$ milvus_cli --version
Milvus_CLI v0.4.0