Compartir a través de

integración de la base de datos .NET AspireMilvus

  • Artículo

En este artículo, aprenderá a usar la integración de base de datos .NET AspireMilvus. La biblioteca de Aspire.Milvus.Client registra un MilvusClient en el contenedor DI para la conexión con un Milvusserver.

Prerrequisitos

  • Milvus server y cadena de conexión para acceder al punto de conexión de la API de server.

Comenzar

Para empezar a trabajar con la integración de la base de datos .NET AspireMilvus, instale el paquete NuGet 📦Aspire.Milvus.Client en el proyecto que consume client, es decir, el proyecto de la aplicación que usa la base de datos Milvusclient.

dotnet add package Aspire.Milvus.Client

Para obtener más información, consulte dotnet add package o Administrar dependencias de paquetes en aplicaciones .NET.

Ejemplo de uso

En el archivo Program.cs del proyecto, llame al método de extensión AddMilvusClient para registrar un MilvusClient para su uso a través del contenedor de inserción de dependencias. El método toma un parámetro de nombre de conexión.

builder.AddMilvusClient("milvus");

Uso del host de la aplicación

Para modelar el recurso de Milvus en el host de la aplicación, instale el 📦Aspire.Hosting.Milvus paquete de NuGet en el host de la aplicación del proyecto .

dotnet add package Aspire.Hosting.Milvus

En el archivo Program.cs de AppHost, registre un Milvusserver y consuma la conexión mediante los métodos siguientes:

var milvus = builder.AddMilvus("milvus");

var myService = builder.AddProject<Projects.MyService>()
                       .WithReference(milvus);

El método WithReference configura una conexión en el proyecto de MyService denominado milvus. En el archivo Program.cs de MyService, la conexión Milvus se puede consumir mediante:

builder.AddMilvusClient("milvus");

Milvus admite contraseñas predeterminadas basadas en la configuración (variable de entorno COMMON_SECURITY_DEFAULTROOTPASSWORD). El usuario predeterminado es root y la contraseña predeterminada es Milvus. Para cambiar la contraseña predeterminada en el contenedor, pase un parámetro apiKey al llamar a la API de hospedaje de AddMilvus:

var apiKey = builder.AddParameter("apiKey");

var milvus = builder.AddMilvus("milvus", apiKey);

var myService = builder.AddProject<Projects.MyService>()
                       .WithReference(milvus);

El código anterior obtiene un parámetro para pasar a la API de AddMilvus y asigna internamente el parámetro a la variable de entorno COMMON_SECURITY_DEFAULTROOTPASSWORD del contenedor de Milvus. El parámetro apiKey normalmente se especifica como secreto de usuario:

{
  "Parameters": {
    "apiKey": "Non-default P@ssw0rd"
  }
}

Para obtener más información, vea Parámetros externos.

Configuración

La integración .NET AspireMilvusClient proporciona varias opciones para configurar la conexión server en función de los requisitos y convenciones del proyecto.

Propina

El uso predeterminado es root y la contraseña predeterminada es Milvus. Actualmente, Milvus no admite cambiar la contraseña de superusuario al iniciarse. Debe cambiarse manualmente con client.

Uso de una cadena de conexión

Al usar una cadena de conexión de la sección de configuración de ConnectionStrings, puede proporcionar el nombre de la cadena de conexión al llamar a builder.AddMilvusClient():

builder.AddMilvusClient("milvus");

Y, a continuación, la cadena de conexión se recuperará de la sección de configuración de ConnectionStrings:

{
  "ConnectionStrings": {
    "milvus": "Endpoint=http://localhost:19530/;Key=root:123456!@#$%"
  }
}

De forma predeterminada, el MilvusClient usa el endpoint de la API gRPC.

Uso de proveedores de configuración

La integración de .NET AspireMilvusClient admite Microsoft.Extensions.Configuration. Carga el MilvusSettings desde la configuración mediante la clave Aspire:Milvus:Client. Considere el ejemplo siguiente appsettings.json que configura algunas de las opciones:

{
  "Aspire": {
    "Milvus": {
      "Client": {
        "Key": "root:123456!@#$%"
      }
    }
  }
}

Utilice delegados insertados

También puede pasar el delegado Action<MilvusSettings> configureSettings para configurar algunas o todas las opciones en línea, por ejemplo, para establecer la clave de API desde el código:

builder.AddMilvusClient(
    "milvus",
    settings => settings.Key = "root:12345!@#$%");

Comprobaciones de estado

De forma predeterminada, las integraciones de .NET.NET Aspire habilitan las verificaciones de salud de para todos los servicios. Para obtener más información, consulte .NET.NET Aspire integrations overview.

La integración de la base de datos de .NET AspireMilvus utiliza el client configurado para llevar a cabo un HealthAsync. Si el resultado es correcto, la comprobación de estado se considera correcta; de lo contrario, es incorrecto. Del mismo modo, si hay una excepción, la verificación de estado se considera no saludable y el error se propaga a través del fallo de la verificación de estado.

Observabilidad y telemetría

.NET .NET Aspire integraciones configuran automáticamente las configuraciones de registro, seguimiento y métricas, que a veces se conocen como los pilares de la observabilidad. Para obtener más información sobre la observabilidad de integración y la telemetría, consulte información general sobre las integraciones de .NET.NET Aspire. En función del servicio de respaldo, algunas integraciones solo pueden admitir algunas de estas características. Por ejemplo, algunas integraciones admiten el registro y el seguimiento, pero no las métricas. Las características de telemetría también se pueden deshabilitar mediante las técnicas presentadas en la sección Configuración.

Registro

La integración de la base de datos .NET AspireMilvus utiliza el registro estándar de .NET y verá entradas de registro de la siguiente categoría:

  • Milvus.Client

Consulte también