Compartilhar via

integração de banco de dados .NET AspireMilvus

  • Artigo

Neste artigo, você aprenderá a usar a integração de banco de dados .NET AspireMilvus. A biblioteca Aspire.Milvus.Client registra um MilvusClient no contêiner de DI para se conectar a um Milvusserver.

Pré-requisitos

  • Milvus server e string de conexão para acessar o endpoint da API server.

Começar

Para começar a usar a integração de banco de dados .NET AspireMilvus, instale o pacote NuGet 📦Aspire.Milvus.Client no projeto que consome client, ou seja, o projeto do aplicativo que utiliza o banco de dados Milvusclient.

dotnet add package Aspire.Milvus.Client

Para obter mais informações, consulte dotnet add package ou Gerenciar dependências de pacotes em .NET applications.

Exemplo de uso

No arquivo Program.cs do seu projeto, chame o método de extensão AddMilvusClient para registrar um MilvusClient para ser usado através do contêiner de injeção de dependência. O método usa um parâmetro de nome de conexão.

builder.AddMilvusClient("milvus");

Uso do host do aplicativo

Para modelar o recurso Milvus no host do aplicativo, instale o pacote NuGet 📦Aspire.Hosting.Milvus no projeto do host do aplicativo.

dotnet add package Aspire.Hosting.Milvus

No arquivo Program.cs de AppHost, registre um Milvusserver e consuma a conexão usando os seguintes métodos:

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

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

O método WithReference configura uma conexão no projeto MyService chamado milvus. No arquivo Program.cs de MyService, a conexão Milvus pode ser consumida usando:

builder.AddMilvusClient("milvus");

Milvus dá suporte a senhas padrão baseadas em configuração (variável de ambiente COMMON_SECURITY_DEFAULTROOTPASSWORD). O usuário padrão é root e a senha padrão é Milvus. Para alterar a senha padrão no contêiner, passe um parâmetro apiKey ao chamar a API de hospedagem AddMilvus:

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

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

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

O código anterior obtém um parâmetro a ser passado para a API AddMilvus e atribui internamente o parâmetro à variável de ambiente COMMON_SECURITY_DEFAULTROOTPASSWORD do contêiner Milvus. O parâmetro geralmente é especificado como um segredo do usuário:

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

Para obter mais informações, consulte Parâmetros externos.

Configuração

A integração .NET AspireMilvusClient fornece várias opções para configurar a conexão server com base nos requisitos e convenções do seu projeto.

Dica

O uso padrão é root e a senha padrão é Milvus. Atualmente, Milvus não dá suporte à alteração da senha do superusuário na inicialização. Isso precisa ser alterado manualmente com o client.

Usar uma cadeia de conexão

Ao usar uma cadeia de conexão da seção de configuração ConnectionStrings, você pode fornecer o nome da cadeia de conexão ao chamar builder.AddMilvusClient():

builder.AddMilvusClient("milvus");

Em seguida, a cadeia de conexão será recuperada da seção de configuração do ConnectionStrings:

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

Por padrão, o MilvusClient usa o endpoint da API gRPC.

Usar provedores de configuração

A integração .NET AspireMilvusClient dá suporte a Microsoft.Extensions.Configuration. Ele carrega o MilvusSettings a partir da configuração utilizando a chave Aspire:Milvus:Client. Considere o exemplo a seguir appsettings.json que configura algumas das opções:

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

Usar delegados embutidos

Além disso, você pode passar o delegado Action<MilvusSettings> configureSettings para definir algumas ou todas as opções diretamente, por exemplo, para definir a chave de API no código:

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

Checagens de saúde

Por padrão, as integrações .NET.NET Aspire ativam verificações de saúde para todos os serviços. Para obter mais informações, consulte .NET.NET Aspire visão geral de integrações.

A integração de banco de dados .NET AspireMilvus usa o client configurado para executar um HealthAsync. Se o resultado for saudável, a verificação de saúde será considerada saudável, caso contrário, não será saudável. Da mesma forma, se houver uma exceção, a verificação de saúde será considerada não saudável, com o erro propagando-se através da falha na verificação de saúde.

Observabilidade e telemetria

.NET .NET Aspire integrações configuram automaticamente Registro, Rastreamento e Métricas, que às vezes são conhecidos como os pilares da observabilidade. Para obter mais informações sobre a observabilidade e a telemetria de integração, consulte .NET.NET Aspire visão geral das integrações. Dependendo do serviço de backup, algumas integrações só podem dar suporte a alguns desses recursos. Por exemplo, algumas integrações dão suporte a registro em log e rastreamento, mas não a métricas. Os recursos de telemetria também podem ser desabilitados usando as técnicas apresentadas na seção Configuration.

Registro

A integração do banco de dados .NET AspireMilvus usa o registro padrão de .NET e você verá entradas de log da seguinte categoria:

  • Milvus.Client

Consulte também