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
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. |
milvus_cli --version
funge da comando.Esempio
$ milvus_cli --version
Milvus_CLI v0.4.0