Partager via

intégration de Qdrant .NET.NET Aspire

  • Article

Dans cet article, vous allez apprendre à utiliser l’intégration .NET.NET Aspire Qdrant. Utilisez cette intégration pour inscrire un QdrantClient dans le conteneur DI afin de se connecter à un serverQdrant.

Démarrer

Pour commencer à utiliser l’intégration .NET.NET Aspire Qdrant, installez le 📦Aspire. Qdrant.Client package NuGet dans le projet clientconsommant, c’est-à-dire le projet pour l’application qui utilise le clientQdrant .

dotnet add package Aspire.Qdrant.Client

Pour plus d’informations, consultez dotnet add package ou Gérer les dépendances de package dans les applications.NET.

Exemple d’utilisation

Dans le fichier Program.cs de votre projet clientconsommant, appelez la méthode d’extension AddQdrantClient pour inscrire un QdrantClient à utiliser via le conteneur d’injection de dépendances. La méthode prend un paramètre de nom de connexion.

builder.AddQdrantClient("qdrant");

Pour récupérer votre objet QdrantClient, considérez l’exemple de service suivant :

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

Utilisation de l’hôte d’application

Pour modéliser la ressource server Qdrant dans l’hôte de l’application, installez le package NuGet 📦Aspire.Hosting.Qdrant dans le projet hôte de l’application .

dotnet add package Aspire.Hosting.Qdrant

Dans votre projet hôte de l'application, inscrivez un Qdrant server et consommez la connexion en utilisant les méthodes suivantes :

var builder = DistributedApplication.CreateBuilder(args);

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

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

Lorsque vous souhaitez fournir explicitement la clé API, vous pouvez la fournir en tant que paramètre. Prenons l’exemple de remplacement suivant :

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

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

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

Pour plus d’informations, consultez paramètres externes.

Configuration

L’intégration Client Qdrant .NET Aspire fournit plusieurs options pour configurer la connexion server en fonction des exigences et des conventions de votre projet.

Utiliser une chaîne de connexion

Lorsque vous utilisez une chaîne de connexion à partir de la section de configuration ConnectionStrings, vous pouvez fournir le nom de la chaîne de connexion lors de l’appel de builder.AddQdrantClient():

builder.AddQdrantClient("qdrant");

Ensuite, la chaîne de connexion est récupérée à partir de la section de configuration ConnectionStrings :

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

Par défaut, le QdrantClient utilise le point de terminaison de l’API gRPC.

Utiliser des fournisseurs de configuration

L'intégration .NET Aspire Qdrant Client prend en charge Microsoft.Extensions.Configuration. Il charge le QdrantClientSettings à partir de la configuration en utilisant la clé Aspire:Qdrant:Client. Exemple appsettings.json qui configure certaines des options suivantes :

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

Utiliser des délégués en ligne

Vous pouvez également transmettre le délégué Action<QdrantClientSettings> configureSettings pour configurer certaines ou toutes les options inline, par exemple pour définir la clé API à partir du code :

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

Observabilité et télémétrie

.NET .NET Aspire intégrations configurent automatiquement les configurations de journalisation, de suivi et de métriques, parfois appelées les piliers de l’observabilité. Pour plus d’informations sur l’observabilité de l’intégration et la télémétrie, consultez .NET.NET Aspire vue d’ensemble des intégrations. Selon le service de stockage, certaines intégrations peuvent uniquement prendre en charge certaines de ces fonctionnalités. Par exemple, certaines intégrations prennent en charge la journalisation et le suivi, mais pas les métriques. Les fonctionnalités de télémétrie peuvent également être désactivées à l’aide des techniques présentées dans la section Configuration.

Exploitation forestière

L’intégration .NET.NET Aspire Qdrant utilise les catégories de journalisation suivantes :

  • "Qdrant.Client"

Voir aussi