Udostępnij za pośrednictwem

integracja z bazą danych .NET AspireMilvus

  • Artykuł

Z tego artykułu dowiesz się, jak korzystać z integracji z bazą danych .NET AspireMilvus. Biblioteka Aspire.Milvus.Client rejestruje MilvusClient w kontenerze DI w celu połączenia z Milvusserver.

Warunki wstępne

  • Milvus server i parametry połączenia na potrzeby uzyskiwania dostępu do punktu końcowego interfejsu API server.

Zacznij

Aby rozpocząć pracę z integracją bazy danych .NET AspireMilvus, zainstaluj 📦Aspire.Milvus.Client pakiet NuGet w projekcie korzystającym z client, tj. projekt dla aplikacji korzystającej z bazy danych Milvusclient.

dotnet add package Aspire.Milvus.Client

Aby uzyskać więcej informacji, zobacz dotnet add package lub Zarządzaj zależnościami pakietów w aplikacjach .NET.

Przykładowe użycie

W pliku o nazwie Program.cs projektu wywołaj metodę rozszerzenia AddMilvusClient, aby zarejestrować MilvusClient do użycia za pomocą kontenera iniekcji zależności. Metoda przyjmuje parametr nazwy połączenia.

builder.AddMilvusClient("milvus");

Użycie hosta aplikacji

Aby modelować zasób Milvus na hoście aplikacji, zainstaluj pakiet NuGet 📦Aspire.Hosting.Milvus w projekcie hosta aplikacji .

dotnet add package Aspire.Hosting.Milvus

Zarejestruj Milvusserver w pliku Program.csAppHosti skorzystaj z połączenia za pomocą następujących metod:

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

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

Metoda WithReference konfiguruje połączenie w projekcie MyService o nazwie milvus. W pliku Program.csMyServicemożna użyć połączenia Milvus przy użyciu:

builder.AddMilvusClient("milvus");

Milvus obsługuje hasła domyślne oparte na konfiguracji (zmienna środowiskowa COMMON_SECURITY_DEFAULTROOTPASSWORD). Domyślny użytkownik to root, a domyślne hasło to Milvus. Aby zmienić domyślne hasło w kontenerze, przekaż parametr apiKey podczas wywoływania interfejsu API hostingu AddMilvus:

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

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

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

Powyższy kod pobiera parametr do przekazania do interfejsu API AddMilvus i wewnętrznie przypisuje parametr do zmiennej środowiskowej COMMON_SECURITY_DEFAULTROOTPASSWORD kontenera Milvus. Parametr apiKey jest zwykle określany jako klucz tajny użytkownika:

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

Aby uzyskać więcej informacji, zobacz Parametry zewnętrzne.

Konfiguracja

Integracja .NET AspireMilvusClient oferuje wiele opcji konfigurowania połączenia server na podstawie wymagań i konwencji projektu.

Napiwek

Domyślne użycie to root, a domyślne hasło to Milvus. Obecnie Milvus nie obsługuje zmiany hasła administratora podczas uruchamiania. Należy ją ręcznie zmienić za pomocą client.

Używanie parametrów połączenia

W przypadku używania parametrów połączenia z sekcji konfiguracji ConnectionStrings można podać nazwę parametrów połączenia podczas wywoływania builder.AddMilvusClient():

builder.AddMilvusClient("milvus");

Następnie parametry połączenia zostaną pobrane z sekcji konfiguracji ConnectionStrings:

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

Domyślnie urządzenie MilvusClient używa punktu końcowego interfejsu API gRPC.

Korzystanie z dostawców konfiguracji

Integracja .NET AspireMilvusClient wspiera Microsoft.Extensions.Configuration. Ładuje MilvusSettings z konfiguracji wykorzystując klucz Aspire:Milvus:Client. Rozważmy poniższy przykład ustawienia aplikacji.json, który konfiguruje niektóre opcje:

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

Używanie delegatów wbudowanych

Możesz również przekazać delegata Action<MilvusSettings> configureSettings, aby skonfigurować niektóre lub wszystkie opcje bezpośrednio, na przykład w celu ustawienia klucza interfejsu API w kodzie:

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

Kontrole kondycji

Domyślnie integracje .NET.NET Aspire umożliwiają kontrole stanu dla wszystkich usług. Aby uzyskać więcej informacji, zobacz omówienie integracji .NET.NET Aspire.

Integracja bazy danych .NET AspireMilvus używa skonfigurowanego client do wykonania HealthAsync. Jeśli wynik jest zdrowy, kontrola zdrowia jest uznawana za zdrową, w przeciwnym razie za niezdrową. Podobnie, jeśli wystąpi wyjątek, sprawdzanie kondycji uznaje się za niezdrowe, a błąd rozprzestrzenia się poprzez awarię sprawdzania kondycji.

Obserwowanie i telemetria

.NET .NET Aspire integracje automatycznie ustawiają konfiguracje rejestrowania, śledzenia i metryk, które są czasami nazywane filarami obserwowalności. Aby uzyskać więcej informacji na temat możliwości obserwacji integracji i telemetrii, zobacz omówienie integracji .NET.NET Aspire. W zależności od usługi pomocniczej niektóre integracje mogą obsługiwać tylko niektóre z tych funkcji. Na przykład niektóre integracje obsługują rejestrowanie i śledzenie, ale nie metryki. Funkcje telemetrii można również wyłączyć przy użyciu technik przedstawionych w sekcji konfiguracji .

Rejestrowanie

Integracja z bazą danych .NET AspireMilvus korzysta ze standardowego rejestrowania .NET i zobaczysz wpisy dziennika z następującej kategorii:

  • Milvus.Client

Zobacz też