Sdílet prostřednictvím

Integrace .NET.NET Aspire Qdrant

  • Článek

V tomto článku se dozvíte, jak používat integraci .NET.NET Aspire Qdrant. Pomocí této integrace zaregistrujte QdrantClient do DI kontejneru pro připojení k Qdrant server.

Začněte

Abyste mohli začít s integrací .NET.NET Aspire Qdrant, nainstalujte balíček 📦Aspire.Qdrant.Client NuGet do projektu používajícího client, tj. projektu pro aplikaci, která používá clientQdrant.

dotnet add package Aspire.Qdrant.Client

Další informace najdete v tématu dotnet add package nebo Správa závislostí balíčků v aplikacích .NET.

Příklad využití

V souboru Program.cs projektu, který využívá client, zavolejte metodu rozšíření AddQdrantClient, která zaregistruje QdrantClient pro použití prostřednictvím kontejneru injektáže závislostí. Metoda přebírá parametr názvu připojení.

builder.AddQdrantClient("qdrant");

Pokud chcete načíst objekt QdrantClient, zvažte použití následujícího příkladu služby:

public class ExampleService(QdrantClient client)
{
    // Use client...
}

Využití hostitele aplikace

Pokud chcete modelovat prostředek Qdrant server v hostiteli aplikace, nainstalujte balíček NuGet 📦Aspire.Hosting.Qdrant v projektu hostitele aplikace .

dotnet add package Aspire.Hosting.Qdrant

V hostitelském projektu aplikace zaregistrujte server Qdrant a využijte připojení pomocí následujících metod:

var builder = DistributedApplication.CreateBuilder(args);

var qdrant = builder.AddQdrant("qdrant");

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

Pokud chcete klíč rozhraní API explicitně zadat, můžete ho zadat jako parametr. Podívejte se na následující alternativní příklad:

var apiKey = builder.AddParameter("apikey", secret: true);

var qdrant = builder.AddQdrant("qdrant", apiKey);

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

Další informace naleznete v tématu Externí parametry.

Konfigurace

Integrace .NET Aspire Qdrant Client poskytuje několik možností konfigurace připojení server na základě požadavků a konvencí projektu.

Použijte připojovací řetězec

Při použití připojovacího řetězce z oddílu konfigurace ConnectionStrings můžete při volání builder.AddQdrantClient()zadat název připojovacího řetězce:

builder.AddQdrantClient("qdrant");

Připojovací řetězec bude načten z konfigurační sekce ConnectionStrings.

{
  "ConnectionStrings": {
    "qdrant": "Endpoint=http://localhost:6334;Key=123456!@#$%"
  }
}

Ve výchozím nastavení QdrantClient používá koncový bod rozhraní API gRPC.

Použití zprostředkovatelů konfigurace

Integrace .NET Aspire Qdrant Client podporuje Microsoft.Extensions.Configuration. Načte QdrantClientSettings z konfigurace pomocí klíče Aspire:Qdrant:Client. Příklad appsettings.json, který konfiguruje některé z možností:

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

Použití vložených delegátů

Můžete také předat delegáta Action<QdrantClientSettings> configureSettings pro nastavení některých nebo všech možností přímo, například nastavit klíč rozhraní API přímo v kódu.

builder.AddQdrantClient("qdrant", settings => settings.ApiKey = "12345!@#$%");

Pozorovatelnost a telemetrie

.NET .NET Aspire integrace automaticky nastaví konfigurace pro protokolování, trasování a metriky, které se někdy označují jako pilíře pozorovatelnosti. Další informace o pozorovatelnosti a telemetrii integrace najdete v přehledu integrace .NET.NET Aspire. V závislosti na zálohovací službě můžou některé integrace podporovat pouze některé z těchto funkcí. Například některé integrace podporují protokolování a trasování, ale ne metriky. Funkce telemetrie je také možné zakázat pomocí technik uvedených v části Konfigurace.

Protokolování

Integrace .NET.NET Aspire Qdrant používá následující kategorie protokolování:

  • "Qdrant.Client"

Viz také