Conexão com o serviço Milvus

Execute qualquer um dos seguintes comandos para se conectar ao Milvus:

Antes de Iniciar

Certifique-se de que os seguintes itens estejam instalados ou disponíveis:

Python e pacote Pymilvus. Para mais informações, veja SobrePyMilvus.
Nome do host e porta da instância Milvus. Você pode obter informações sobre Milvus host e port no Infrastructure Manager (clique no serviço Milvus para abrir a página Details (Detalhes ) e observe as informações host e port do host GRPC).
Atribuir uma função ao usuário ou ID do serviço de Gerente de infraestrutura. Para obter informações sobre funções de usuário, consulte Gerenciamento de funções e privilégios.

Procedimento

Você pode se conectar a um serviço Milvus usando uma chave de API ou um token IAM.

Provisione um serviço Milvus em watsonx.data. Para obter mais informações, consulte Adição de um serviço Milvus.

Execute um dos seguintes comandos usando o Python SDK PyMilvus ) para se conectar ao Milvus para a rota gRPC:

Use um dos seguintes comandos para se conectar a Milvus usando chamadas GRPC:

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

from pymilvus import MilvusClient, DataType

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

Substitua ' <api-key> pela chave de API da IBM. Para obter informações sobre como obter uma chave de API, consulte Obtendo a chave de API da IBM.

Use um dos seguintes comandos para se conectar a Milvus usando o token IAM:

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

from pymilvus import MilvusClient, DataType

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

Substitua <token> pelo token do IAM. Para obter informações sobre como obter um token, consulte Obtendo o token do IBM Access Management(IAM).

Use um dos seguintes comandos para se conectar a Milvus usando o URI (Uniform Resource Identifier):

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

from pymilvus import MilvusClient, DataType

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

Substitua <token> pelo token do IAM. Para obter informações sobre como obter um token, consulte Obtendo o token do IBM Access Management(IAM).

Para se conectar a Milvus usando a rota REST e fazer uma chamada de API, execute o seguinte 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"
```
Para obter mais informações, consulte Referência da API RESTful.

Recomenda-se usar as APIs por meio da rota de proxy. As APIs por meio da rota REST estão obsoletas e podem ser removidas em uma versão futura.

Para se conectar a Milvus usando a rota de proxy e fazer uma chamada de API, execute o seguinte 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"
}'

Por exemplo:

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:<value of api key>' | base64)" \
--header 'Content-Type: application/json'
-d '{
    "dbName": "default"
}'

A partir da versão watsonx.data 2.2, recomenda-se usar a versão da API v2/. A versão da API v1/ pode ser preterida e removida em uma versão futura.

Na versão Milvus das APIs v2/, a categoria User and Roles das APIs não é compatível com o serviço Milvus em watsonx.data. Para obter mais informações, consulte Milvus APIs.

O quê fazer em seguida

Você pode realizar as seguintes operações depois de estabelecer uma conexão com um serviço Milvus:

Gerenciar dados
- Você pode inserir, fazer upsert ou excluir dados no serviço Milvus. Para obter mais informações, consulte Inserir, Upsert e Excluir.
- Você pode importar dados do Milvus. Para obter mais informações, consulte Preparar e importar dados
Gerenciar bancos de dados: É possível criar bancos de dados no Milvus e atribuir privilégios a determinados usuários para gerenciá-los. Um cluster Milvus suporta um máximo de 64 bancos de dados. Para mais informações, veja Gerenciar bancos de dados.
Gerenciar coleções: Você pode criar e gerenciar coleções usando o SDK de sua escolha. Um cluster Milvus suporta um máximo de 65.536 coleções. Para mais informações, veja Gerenciar coleções.
Gerenciar partições: É possível criar e gerenciar partições em uma coleção. Um cluster Milvus suporta um máximo de 4095 partições. Para mais informações, veja Gerenciar partições.
Gerenciar índices: É possível criar e gerenciar índices em campos vetoriais em uma coleção. Para obter mais informações, consulte Gerenciar índices.
Pesquisa e consulta: Para obter informações sobre pesquisa e consulta de dados em Milvus, consulte Search, Query e Get.

API relacionada

Para obter informações sobre a API relacionada, consulte