milvus-logo
LFAI
Casa
  • Strumenti

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

OpzioneNome completoDescrizione
-aiuton/aVisualizza la guida all'uso del comando.

connetti

Connette a Milvus.

Sintassi

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

Opzioni

OpzioneNome completoDescrizione
-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.
-helpn/aVisualizza 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

OpzioneNome completoDescrizione
-db-database[Il nome del database in milvus.
-helpn/aVisualizza 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

OpzioneNome completoDescrizione
-db-database[Il nome del database in milvus.
-helpn/aVisualizza 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

OpzioneNome completoDescrizione
-db-database[Il nome del database in milvus.
-helpn/aVisualizza 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

OpzioneNome completoDescrizione
-p-passwordLa password dell'utente in milvus. L'impostazione predefinita è "Nessuno".
-u-nome utenteIl nome utente in milvus. L'impostazione predefinita è "Nessuno".
-helpn/aVisualizza 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.

Una collezione può avere più alias. Tuttavia, un alias corrisponde al massimo a una collezione.

Sintassi

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

Opzioni

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta.
-a-nome aliasL'alias.
-A-alter(Facoltativo) Flag per trasferire l'alias a una raccolta specificata.
-aiuton/aVisualizza 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 2 si basa sull'esempio 1.

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

OpzioniNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta.
-f-schema-campo(Multiplo) Lo schema del campo nel formato <fieldName>:<dataType>:<dimOfVector/desc>.
-p-schema-campo primarioIl 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
-aiuton/aVisualizza 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

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta.
-p-partizioneIl nome della partizione.
-d-descrizione(Opzionale) La descrizione della partizione.
-helpn/aVisualizza 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.

Attualmente, una collezione supporta un massimo di un indice.

Sintassi

create index

Opzioni

OpzioneNome completoDescrizione
-aiuton/aVisualizza 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

OpzioneNome completoDescrizione
-u-Nome utenteIl nome utente.
-helpn/aVisualizza la guida all'uso del comando.

Esempio

milvus_cli > delete user -u zilliz

elimina alias

Elimina un alias.

Sintassi

delete alias -a (text) 

Opzioni

OpzioneNome completoDescrizione
-a-nome aliasL'alias.
-aiuton/aVisualizza la guida all'uso del comando.

elimina raccolta

Elimina una raccolta.

Sintassi

delete collection -c (text) 

Opzioni

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta da eliminare.
-aiuton/aVisualizza 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

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta a cui appartengono le entità da eliminare.
-p-partizione(Opzionale) Il nome della partizione da eliminare.
-helpn/aVisualizza 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

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta a cui appartiene la partizione da eliminare.
-p-partizioneIl nome della partizione da eliminare.
-helpn/aVisualizza 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.

Attualmente, una collezione supporta al massimo un indice.

Sintassi

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

Opzioni

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta.
-in-nome indiceIl nome dell'indice.
-helpn/aVisualizza 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

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta.
-aiuton/aVisualizza 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

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta a cui appartiene la partizione.
-p-partizioneIl nome della partizione.
-helpn/aVisualizza 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

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta.
-in-Nome dell'indiceIl 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

OpzioneNome completoDescrizione
-aiuton/aVisualizza la guida all'uso del comando.

Aiuto

Visualizza la guida all'uso di un comando.

Sintassi

help <command>

Comandi

ComandoDescrizione
CancellaCancella lo schermo.
ConnettiSi collega a Milvus.
creareCrea una raccolta, un database, una partizione, un utente e un indice.
CancellareElimina raccolta, database, partizione, alias, utente o indice.
EsciChiude la finestra della riga di comando.
AiutoVisualizza la guida all'uso di un comando.
InserisciImporta i dati in una partizione.
elencaElenca collezioni, database, partizioni, utenti o indici.
caricareCarica una raccolta o una partizione.
queryMostra i risultati delle query che corrispondono a tutti i criteri immessi.
RilascioRilascia una raccolta o una partizione.
RicercaEsegue una ricerca di similarità vettoriale o una ricerca ibrida.
MostraMostra la connessione, il database, la collezione, l'avanzamento del caricamento o l'avanzamento dell'indice.
rinominareRinomina la raccolta
usaUsa il database
versioneMostra la versione di Milvus_CLI.

Importazione

Importa i dati locali o remoti in una partizione.

Sintassi

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

Opzioni

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl 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".
-helpn/aVisualizza 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

OpzioniNome completoDescrizione
-aiuton/aVisualizza la guida all'uso del comando.

elenca indici

Elenca tutti gli indici di una collezione.

Attualmente, una collezione supporta al massimo un indice.

Sintassi

list indexes -c (text)

Opzioni

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta.
-aiuton/aVisualizza la guida all'uso del comando.

elenca partizioni

Elenca tutte le partizioni di una raccolta.

Sintassi

list partitions -c (text)

Opzioni

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta.
-aiuton/aVisualizza 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

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta a cui appartiene la partizione.
-p-partizione(Opzionale/Multiplo) Il nome della partizione.
-helpn/aVisualizza la guida all'uso del comando.

query

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

Sintassi

query

Opzioni

OpzioneNome completoDescrizione
-aiuton/aVisualizza 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

OpzioneNome completoDescrizione
-c-Nome della raccoltaIl nome della raccolta a cui appartiene la partizione.
-p-partizione(Opzionale/Multiplo) Il nome della partizione.
-helpn/aVisualizza la guida all'uso del comando.

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

search

OpzioneNome completoDescrizione
-aiuton/aVisualizza la guida all'uso del comando.

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

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

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

OpzioneNome completoDescrizione
-aiuton/aVisualizza 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

OpzioneNome completoDescrizione
-c-Nome della collezioneIl nome della collezione a cui appartengono le entità.
-i-indice(Opzionale) Il nome dell'indice.
-helpn/aVisualizza 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

OpzioneNome completoDescrizione
-c-Nome della collezioneIl nome della collezione a cui appartengono le entità.
-p-partizione(Opzionale/Multiplo) Il nome della partizione di caricamento.
-helpn/aVisualizza la guida all'uso del comando.

versione

Mostra la versione di Milvus_CLI.

Sintassi

version

Opzioni

OpzioneNome completoDescrizione
-aiuton/aVisualizza la guida all'uso del comando.
È anche possibile verificare la versione di Milvus_CLI in una shell, come mostrato nell'esempio seguente. In questo caso, milvus_cli --version funge da comando.

Esempio

$ milvus_cli --version
Milvus_CLI v0.4.0