Riferimento comandi Milvus_CLI

L'interfaccia a riga di comando (CLI) di Milvus è uno strumento a riga di comando che supporta la connessione al database, le operazioni sui dati e l'importazione e l'esportazione dei dati.

Questo argomento introduce tutti i comandi supportati e le opzioni corrispondenti. Sono inclusi anche alcuni esempi di riferimento.

Cancella

Cancella lo schermo.

Sintassi

clear

Opzioni

Opzione	Nome completo	Descrizione
-aiuto	n/a	Visualizza la guida all'uso del comando.

connetti

Connette a Milvus.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-uri	-uri	(Opzionale) Il nome dell'uri. Il valore predefinito è "http://127.0.0.1:19530".
-t	-token	(Facoltativo) L'apikey del cloud zilliz o username:password. Il valore predefinito è Nessuno.
-help	n/a	Visualizza la guida all'uso del comando.

Esempio

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

crea Database

Crea database in Milvus

Sintassi

create database -db (text) 

Opzioni

Opzione	Nome completo	Descrizione
-db	-database	[Il nome del database in milvus.
-help	n/a	Visualizza la guida all'uso del comando.

Esempi

Esempio 1

L'esempio seguente crea il database testdb in milvus.

milvus_cli > create database -db testdb

usa database

Usa database in Milvus

Sintassi

use database -db (text) 

Opzioni

Opzione	Nome completo	Descrizione
-db	-database	[Il nome del database in milvus.
-help	n/a	Visualizza la guida all'uso del comando.

Esempi

Esempio 1

L'esempio seguente utilizza il database testdb in milvus.

milvus_cli > use database -db testdb

elenca database

Elenco dei database in Milvus

Sintassi

list databases 

Esempi

Esempio 1

L'esempio seguente elenca i database di Milvus.

milvus_cli > list databases

Elimina database

Cancellare un database in Milvus

Sintassi

delete database -db (text) 

Opzioni

Opzione	Nome completo	Descrizione
-db	-database	[Il nome del database in milvus.
-help	n/a	Visualizza la guida all'uso del comando.

Esempi

Esempio 1

L'esempio seguente cancella il database testdb in milvus.

milvus_cli > delete database -db testdb

crea utente

Creare un utente in Milvus

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-p	-password	La password dell'utente in milvus. L'impostazione predefinita è "Nessuno".
-u	-nome utente	Il nome utente in milvus. L'impostazione predefinita è "Nessuno".
-help	n/a	Visualizza la guida all'uso del comando.

Esempi

Esempio 1

L'esempio seguente crea l'utente zilliz e la password zilliz in milvus.

milvus_cli > create user -u zilliz -p zilliz

crea alias

Specifica alias univoci per una raccolta.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta.
-a	-nome alias	L'alias.
-A	-alter	(Facoltativo) Flag per trasferire l'alias a una raccolta specificata.
-aiuto	n/a	Visualizza la guida all'uso del comando.

Esempi

Esempio 1

L'esempio seguente crea gli alias carAlias1 e carAlias2 per la collezione car.

milvus_cli > create alias -c car -a carAlias1

Esempio 2

L'esempio seguente trasferisce l'alias carAlias1 dalla raccolta car alla raccolta car2.

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

crea collezione

Crea una raccolta.

Sintassi

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

Opzioni

Opzioni	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta.
-f	-schema-campo	(Multiplo) Lo schema del campo nel formato <fieldName>:<dataType>:<dimOfVector/desc>.
-p	-schema-campo primario	Il nome del campo chiave primaria.
-a	-schema-auto-id	(Opzionale) Flag per generare automaticamente gli ID.
-desc	-schema-descrizione	(Facoltativo) La descrizione della raccolta.
-livello	-livello di coerenza	(Facoltativo) Livello di coerenza: Limitato, Sessione, Forte, Eventuale .
-d	-è-dinamico	(Opzionale) Lo schema della collezione supporta o meno i campi dinamici.
-s	-shards-num	(Opzionale) Numero di frammenti
-aiuto	n/a	Visualizza la guida all'uso del comando.

Esempio

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

crea partizione

Crea una partizione.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta.
-p	-partizione	Il nome della partizione.
-d	-descrizione	(Opzionale) La descrizione della partizione.
-help	n/a	Visualizza la guida all'uso del comando.

Esempio

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

crea indice

Crea un indice per un campo.

Sintassi

create index

Opzioni

Opzione	Nome completo	Descrizione
-aiuto	n/a	Visualizza la guida all'uso del comando.

Esempio

Per creare un indice per un campo e richiedere l'immissione dei dati richiesti:

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

elimina utente

Elimina un utente

Sintassi

delete user -u (text)

Opzioni

Opzione	Nome completo	Descrizione
-u	-Nome utente	Il nome utente.
-help	n/a	Visualizza la guida all'uso del comando.

Esempio

milvus_cli > delete user -u zilliz

elimina alias

Elimina un alias.

Sintassi

delete alias -a (text) 

Opzioni

Opzione	Nome completo	Descrizione
-a	-nome alias	L'alias.
-aiuto	n/a	Visualizza la guida all'uso del comando.

elimina raccolta

Elimina una raccolta.

Sintassi

delete collection -c (text) 

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta da eliminare.
-aiuto	n/a	Visualizza la guida all'uso del comando.

Esempio

milvus_cli > delete collection -c car

elimina entità

Elimina le entità.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta a cui appartengono le entità da eliminare.
-p	-partizione	(Opzionale) Il nome della partizione da eliminare.
-help	n/a	Visualizza la guida all'uso del comando.

Esempio

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

elimina partizione

Elimina una partizione.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta a cui appartiene la partizione da eliminare.
-p	-partizione	Il nome della partizione da eliminare.
-help	n/a	Visualizza la guida all'uso del comando.

Esempio

milvus_cli > delete partition -c car -p new_partition

elimina indice

Elimina un indice e i file di indice corrispondenti.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta.
-in	-nome indice	Il nome dell'indice.
-help	n/a	Visualizza la guida all'uso del comando.

Esempio

milvus_cli > delete index -c car -in indexName

mostra collezione

Mostra le informazioni dettagliate di una collezione.

Sintassi

show collection -c (text)

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta.
-aiuto	n/a	Visualizza la guida all'uso del comando.

Esempio

milvus_cli > show collection -c test_collection_insert

mostra partizione

Mostra le informazioni dettagliate di una partizione.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta a cui appartiene la partizione.
-p	-partizione	Il nome della partizione.
-help	n/a	Visualizza la guida all'uso del comando.

Esempio

milvus_cli > show partition -c test_collection_insert -p _default

mostra indice

Mostra le informazioni dettagliate di un indice.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta.
-in	-Nome dell'indice	Il nome dell'indice.

| --help | n/a | Visualizza la guida all'uso del comando. |

Esempio

milvus_cli > show index -c test_collection -in index_name

Esci

Chiude la finestra della riga di comando.

Sintassi

exit

Opzioni

Opzione	Nome completo	Descrizione
-aiuto	n/a	Visualizza la guida all'uso del comando.

Aiuto

Visualizza la guida all'uso di un comando.

Sintassi

help <command>

Comandi

Comando	Descrizione
Cancella	Cancella lo schermo.
Connetti	Si collega a Milvus.
creare	Crea una raccolta, un database, una partizione, un utente e un indice.
Cancellare	Elimina raccolta, database, partizione, alias, utente o indice.
Esci	Chiude la finestra della riga di comando.
Aiuto	Visualizza la guida all'uso di un comando.
Inserisci	Importa i dati in una partizione.
elenca	Elenca collezioni, database, partizioni, utenti o indici.
caricare	Carica una raccolta o una partizione.
query	Mostra i risultati delle query che corrispondono a tutti i criteri immessi.
Rilascio	Rilascia una raccolta o una partizione.
Ricerca	Esegue una ricerca di similarità vettoriale o una ricerca ibrida.
Mostra	Mostra la connessione, il database, la collezione, l'avanzamento del caricamento o l'avanzamento dell'indice.
rinominare	Rinomina la raccolta
usa	Usa il database
versione	Mostra la versione di Milvus_CLI.

Importazione

Importa i dati locali o remoti in una partizione.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta in cui vengono inseriti i dati.
-p	-partizione	(Opzionale) Il nome della partizione in cui vengono inseriti i dati. Se non si passa questa opzione di partizione, si sceglie la partizione "_default".
-help	n/a	Visualizza la guida all'uso del comando.

Esempio 1

L'esempio seguente importa un file CSV locale.

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

Esempio 2

L'esempio seguente importa un file CSV remoto.

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

elenca utenti

Elenca tutti gli utenti.

Sintassi

list users

Opzioni

| Opzione | Nome completo | Descrizione | | --help | n/a | Visualizza la guida all'uso del comando. |

elenca collezioni

Elenca tutte le raccolte.

Sintassi

list collections

Opzioni

Opzioni	Nome completo	Descrizione
-aiuto	n/a	Visualizza la guida all'uso del comando.

elenca indici

Elenca tutti gli indici di una collezione.

Sintassi

list indexes -c (text)

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta.
-aiuto	n/a	Visualizza la guida all'uso del comando.

elenca partizioni

Elenca tutte le partizioni di una raccolta.

Sintassi

list partitions -c (text)

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta.
-aiuto	n/a	Visualizza la guida all'uso del comando.

Carica

Carica una raccolta o una partizione dal disco rigido alla RAM.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta a cui appartiene la partizione.
-p	-partizione	(Opzionale/Multiplo) Il nome della partizione.
-help	n/a	Visualizza la guida all'uso del comando.

query

Mostra i risultati della query che corrispondono a tutti i criteri immessi.

Sintassi

query

Opzioni

Opzione	Nome completo	Descrizione
-aiuto	n/a	Visualizza la guida all'uso del comando.

Esempio

Esempio 1

Per eseguire una query e ricevere un prompt per l'immissione dei dati richiesti:

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

Esempio 2

Per eseguire un'interrogazione e ricevere l'input richiesto:

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

rilasciare

Rilascia una raccolta o una partizione dalla RAM.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della raccolta	Il nome della raccolta a cui appartiene la partizione.
-p	-partizione	(Opzionale/Multiplo) Il nome della partizione.
-help	n/a	Visualizza la guida all'uso del comando.

ricerca

Esegue una ricerca di similarità vettoriale o una ricerca ibrida.

Sintassi

search

Opzioni

Opzione	Nome completo	Descrizione
-aiuto	n/a	Visualizza la guida all'uso del comando.

Esempi

Esempio 1

Per eseguire una ricerca su un file csv e richiedere i dati richiesti:

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

Esempio 2

Per eseguire una ricerca su una raccolta indicizzata e richiedere i dati richiesti:

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

Esempio 3

Per eseguire una ricerca su una raccolta non indicizzata e ricevere l'input richiesto:

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

elenco connessioni

Elencare le connessioni.

Sintassi

list connections 

Opzioni

Opzione	Nome completo	Descrizione
-aiuto	n/a	Visualizza la guida all'uso del comando.

show index_progress

Mostra l'avanzamento dell'indicizzazione delle entità.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della collezione	Il nome della collezione a cui appartengono le entità.
-i	-indice	(Opzionale) Il nome dell'indice.
-help	n/a	Visualizza la guida all'uso del comando.

mostra avanzamento_caricamento

Visualizza l'avanzamento del caricamento di una raccolta.

Sintassi

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

Opzioni

Opzione	Nome completo	Descrizione
-c	-Nome della collezione	Il nome della collezione a cui appartengono le entità.
-p	-partizione	(Opzionale/Multiplo) Il nome della partizione di caricamento.
-help	n/a	Visualizza la guida all'uso del comando.

versione

Mostra la versione di Milvus_CLI.

Sintassi

version

Opzioni

Opzione	Nome completo	Descrizione
-aiuto	n/a	Visualizza la guida all'uso del comando.

Esempio

$ milvus_cli --version
Milvus_CLI v0.4.0