Connessione al Milvus servizio

Esegui uno dei seguenti comandi per connetterti con Milvus:

Prima di iniziare

Assicurarsi che i seguenti elementi siano installati o disponibili:

Python e pacchetto Pymilvus. Per ulteriori informazioni, vedere DiPyMilvus.
Nome host e porta dell'istanza Milvus. È possibile ottenere le informazioni di Milvus host e port da Infrastructure manager (fare clic sul servizio Milvus per aprire la pagina dei dettagli e notare le informazioni host e port dell'host GRPC).
Assegnare un ruolo all'utente o identificativo del servizio da Gestore delle infrastrutture. Per informazioni sui ruoli degli utenti, vedere Gestione di ruoli e privilegi.

Procedura

A partire dalla watsonx.data versione 2.2.0, l'autenticazione utilizzando ibmlhapikey e ibmlhtoken come nomi utente è deprecata. Questi formati vengono gradualmente eliminati nella 2.3.0 versione. Per garantire la compatibilità con le prossime versioni, utilizzare il nuovo formato:ibmlhapikey_<username> e ibmlhtoken_<username>.

È possibile connettersi a un servizio Milvus utilizzando una chiave API o un token IAM.

Predisporre un servizio Milvus in watsonx.data. Per ulteriori informazioni, vedere Aggiunta di un servizio Milvus.

Eseguire uno dei seguenti comandi utilizzando l'SDK PythonPyMilvus ) per connettersi con Milvus per la rotta gRPC:

Utilizzare uno dei seguenti comandi per connettersi a Milvus utilizzando chiamate GRPC:

print(fmt.format("start connecting to Milvus"))
connections.connect(host="<host>", port="<port>", secure=True, user="ibmlhapikey_<username>", password="<api-key>")
has = utility.has_collection("hello_milvus")
print(f"Does collection hello_milvus exist in Milvus: {has}")

oppure

from pymilvus import MilvusClient, DataType

client = MilvusClient(
   host=<host>,
   port=<port>,
   secure=True,
   user="ibmlhapikey_<username>",
   password="<api-key>"
)

Sostituisci <api-key> con la IBM chiave API. Per informazioni su come ottenere una chiave API, consulta Ottenere una chiave IBM API.

Utilizzare uno dei seguenti comandi per connettersi a Milvus utilizzando il token IAM:

connections.connect(host="<host>", port="<port>", secure=True, user="ibmlhtoken_<username>", password="<token>")

oppure

from pymilvus import MilvusClient, DataType

milvus_uri = "https://<ibmlhtoken_<username>>:<token>@<host>:<port>"
client = MilvusClient(
    uri=milvus_uri,
    secure=True
)

Sostituire '<token> con il token IAM. Per informazioni su come ottenere un token, consulta Ottenere il token di IBM gestione degli accessi(IAM).

Utilizzare uno dei seguenti comandi per connettersi a Milvus utilizzando l'Uniform Resource Identifier (URI):

print(fmt.format("start connecting to Milvus"))
connections.connect( alias="default", uri="https://<host>:<grpc-port>", user = "ibmlhtoken_<username>", password = "<token>" )
has = utility.has_collection("hello_milvus")
print(f"Does collection hello_milvus exist in Milvus: {has}")

oppure

from pymilvus import MilvusClient, DataType

milvus_uri = "https://<ibmlhapikey_<username>>:<api-key>@<host>:<port>"
client = MilvusClient(
   uri=milvus_uri,
   secure=True
)

Sostituire '<token> con il token IAM. Per informazioni su come ottenere un token, consulta Ottenere il token di IBM gestione degli accessi(IAM).

Per collegarsi a Milvus utilizzando la rotta REST ed effettuare una chiamata API, eseguire il seguente comando:
```
curl --request GET \
     --url "https://<REST-host>:<REST-port>/api/v1/vector/collections" \
     --header "Authorization: Basic $(echo -n '<user>:<password>' | base64)" \
     --header "Content-Type: application/json"
```
Per ulteriori informazioni, consultare il riferimento all'API RESTful.

Si consiglia di utilizzare le API attraverso il percorso proxy. Le API attraverso il percorso REST sono deprecate e potrebbero essere rimosse in una versione futura.

Per collegarsi a Milvus utilizzando la rotta proxy ed effettuare una chiamata API, eseguire il seguente comando:

curl --request POST \
--url "https://<proxy-host>:<port>/v2/vectordb/collections/list" \
--header "Authorization: Basic $(echo -n 'user:password' | base64)" \
--header "Content-Type: application/json" \
-d '{
    "dbName": "default"
}'

Ad esempio:

curl --request POST \
--url "https://e633a638-420b-499c-9291-288e425a2d25.cdc406pd09pasng7elgg.lakehouse.dev.appdomain.cloud:32699/v2/vectordb/collections/list" \
--header 'accept: application/json' \
--header "Authorization: Basic $(echo -n 'ibmlhapikey_<username>:<value of api key>' | base64)" \
--header 'Content-Type: application/json'
-d '{
    "dbName": "default"
}'

A partire dalla watsonx.data versione 2.2, si consiglia di utilizzare la versione API v2/. La versione v1/ API potrebbe essere deprecata e rimossa in una versione futura.

Nelle API Milvus della v2/ versione, la categoria API Utente e Ruoli non è supportata per il Milvus servizio in watsonx.data. Per ulteriori informazioni, consultare Milvus API.

Cosa fare successivamente

Dopo aver stabilito una connessione con un servizio Milvus, è possibile eseguire le seguenti operazioni:

Gestisci i dati
- È possibile inserire, inserire o cancellare dati nel servizio Milvus. Per ulteriori informazioni, vedere Inserisci, Upsert ed Elimina.
- È possibile importare dati da Milvus. Per ulteriori informazioni, vedere Preparazione e importazione dei dati
Gestire i database: È possibile creare database in Milvus e assegnare a determinati utenti i privilegi per gestirli. Un cluster Milvus supporta un massimo di 64 database. Per ulteriori informazioni, vedere Gestisci database.
Gestire le raccolte: È possibile creare e gestire collezioni utilizzando l'SDK di vostra scelta. Un cluster Milvus supporta un massimo di 65.536 collezioni. Per ulteriori informazioni, vedere Gestisci raccolte.
Gestire le partizioni: È possibile creare e gestire partizioni in una raccolta. Un cluster Milvus supporta un massimo di 4095 partizioni. Per ulteriori informazioni, vedere Gestisci partizioni.
Gestire gli indici: È possibile creare e gestire indici sui campi vettoriali di una collezione. Per ulteriori informazioni, vedere Gestione degli indici.
Ricerca e interrogazione: Per informazioni sulla ricerca e l'interrogazione dei dati in Milvus, vedere Ricerca, Query e Ottieni.

API correlate

Per informazioni sulle API correlate, vedere