Conectándose al Milvus servicio

Ejecute cualquiera de los siguientes comandos para conectarse con Milvus:

Antes de empezar

Asegúrese de que los siguientes elementos estén instalados o disponibles:

Python y paquete Pymilvus. Para más información, ver Acerca dePyMilvus.
Nombre de host y puerto para la instancia de Milvus. Puede obtener información de Milvus host y port en Gestor de infraestructuras (haga clic en el servicio Milvus para abrir la página Detalles y anote la información host y port del host GRPC).
Asignar un rol al usuario o ID de servicio de administrador de infraestructura. Para obtener información sobre las funciones de los usuarios, consulte Gestión de funciones y privilegios.

Procedimiento

A partir de watsonx.data la versión 2.2.0, la autenticación utilizando ibmlhapikey y ibmlhtoken como nombres de usuario queda obsoleta. Estos formatos se eliminan gradualmente en 2.3.0 la versión. Para garantizar la compatibilidad con las próximas versiones, utilice el nuevo formato:ibmlhapikey_<username> y ibmlhtoken_<username>.

Puede conectarse a un servicio Milvus utilizando una clave API o un token IAM.

Aprovisionar un servicio Milvus en watsonx.data. Para más información, consulte Añadir un servicio Milvus.

Ejecute uno de los siguientes comandos utilizando Python SDK PyMilvus ) para conectar con Milvus para la ruta gRPC:

Utilice uno de los siguientes comandos para conectarse a Milvus mediante llamadas 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}")

from pymilvus import MilvusClient, DataType

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

Reemplaza <api-key> con la clave IBM API. Para obtener información sobre cómo obtener una clave API, consulte Obtener clave IBM API.

Utilice uno de los siguientes comandos para conectarse a Milvus utilizando el token IAM:

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

from pymilvus import MilvusClient, DataType

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

Reemplaza <token> por el token IAM. Para obtener información sobre cómo obtener un token, consulte Obtener un token de IBM gestión de acceso(IAM).

Utilice uno de los siguientes comandos para conectarse a Milvus mediante el Identificador Uniforme de Recursos (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}")

from pymilvus import MilvusClient, DataType

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

Reemplaza <token> por el token IAM. Para obtener información sobre cómo obtener un token, consulte Obtener un token de IBM gestión de acceso(IAM).

Para conectarse a Milvus utilizando la ruta REST y realizar una llamada a la API, ejecute el siguiente 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 más información, consulte la referencia API RESTful.

Se recomienda utilizar las API a través de la ruta proxy. Las API a través de la ruta REST están obsoletas y podrían eliminarse en una futura versión.

Para conectarse a Milvus utilizando la ruta proxy y realizar una llamada a la API, ejecute el siguiente 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 ejemplo:

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 partir de watsonx.data la versión 2.2, se recomienda utilizar la versión de la v2/ API. La versión de la v1/ API podría quedar obsoleta y eliminarse en una versión futura.

En las Milvus API v2/ de versión, la categoría de API de usuario y roles no es compatible con el Milvus servicio en watsonx.data. Para obtener más información, consulte Milvus API.

Qué hacer a continuación

Puede realizar las siguientes operaciones después de establecer una conexión con un servicio Milvus:

Gestionar datos
- Puede insertar, insertar hacia arriba o eliminar datos en el servicio Milvus. Para obtener más información, consulte Insertar, volver a insertar y eliminar.
- Puede importar datos de Milvus. Para más información, véase Preparar e importar datos
Gestionar bases de datos: Puede crear bases de datos en Milvus y asignar privilegios a determinados usuarios para gestionarlas. Un clúster Milvus admite un máximo de 64 bases de datos. Para más información, ver Administrar bases de datos.
Gestionar colecciones: Puedes crear y gestionar colecciones utilizando el SDK de tu elección. Un clúster Milvus admite un máximo de 65.536 colecciones. Para más información, ver Administrar colecciones.
Gestionar particiones: Puede crear y gestionar particiones en una colección. Un clúster Milvus admite un máximo de 4095 particiones. Para más información, ver Administrar particiones.
Gestionar índices: Puede crear y gestionar índices en campos vectoriales de una colección. Para más información, consulte Gestionar índices.
Búsqueda y consulta: Para obtener información sobre la búsqueda y consulta de datos en Milvus, consulte Buscar, Consultar y Obtener.

API relacionada

Para obtener información sobre las API relacionadas, consulte