.NET Aspire Milvus 데이터베이스 통합

아티클
12/12/2024

이 문서에서는 .NET AspireMilvus 데이터베이스 통합을 사용하는 방법을 알아봅니다. DI 컨테이너에 MilvusClient를 등록하여 Milvusserver에 연결하기 위해 Aspire.Milvus.Client 라이브러리를 사용합니다.

필수 구성 요소

Milvus server 및 server API 엔드포인트에 액세스하기 위한 연결 문자열입니다.

시작

.NET Aspire Milvus 데이터베이스 통합을 시작하려면 📦Aspire를 설치합니다.Milvus. client을 사용하는 프로젝트, 즉 Milvus 데이터베이스 client을 사용하는 애플리케이션용 프로젝트에서 NuGet 패키지를Client 설치합니다.

.NET CLI
PackageReference

dotnet add package Aspire.Milvus.Client

<PackageReference Include="Aspire.Milvus.Client"
                  Version="*" />

자세한 내용은 dotnet add package 또는 .NET 응용 프로그램에서 패키지 종속성을 관리하기를 참조하세요..

사용 예

프로젝트의 Program.cs 파일에서, 종속성 주입 컨테이너를 통해 사용할 수 있도록 AddMilvusClient 확장 메서드를 호출하여 MilvusClient을 등록하세요. 메서드는 연결 이름 매개 변수를 사용합니다.

builder.AddMilvusClient("milvus");

앱 호스트 사용

앱 호스트에서 Milvus 리소스를 모델링하려면 📦Aspire.Hosting.Milvus NuGet 패키지를 앱 호스트 프로젝트에 설치합니다.

.NET CLI
패키지 참조

dotnet add package Aspire.Hosting.Milvus

<PackageReference Include="Aspire.Hosting.Milvus"
                  Version="*" />

AppHost의 Program.cs 파일에서 Milvusserver를 등록하고 다음 메서드를 사용하여 연결을 사용하십시오.

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

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

WithReference 메서드는 MyService 프로젝트의 milvus라는 연결을 구성합니다. MyService Program.cs 파일에서 다음을 사용하여 Milvus 연결을 사용할 수 있습니다.

builder.AddMilvusClient("milvus");

Milvus 구성 기반(환경 변수 COMMON_SECURITY_DEFAULTROOTPASSWORD) 기본 암호를 지원합니다. 기본 사용자는 root 기본 암호는 Milvus. 컨테이너의 기본 암호를 변경하려면 AddMilvus 호스팅 API를 호출할 때 apiKey 매개 변수를 전달합니다.

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

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

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

앞의 코드는 AddMilvus API에 전달할 매개 변수를 가져오고 내부적으로 Milvus 컨테이너의 COMMON_SECURITY_DEFAULTROOTPASSWORD 환경 변수에 매개 변수를 할당합니다. apiKey 매개 변수는 일반적으로 사용자 비밀로 지정됩니다.

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

자세한 내용은외부 매개 변수를 참조하세요.

구성

.NET Aspire Milvus Client 통합은 프로젝트의 요구 사항 및 규칙에 따라 server 연결을 구성하는 여러 옵션을 제공합니다.

팁

기본 사용은 root 기본 암호는 Milvus. 현재 Milvus 시작 시 슈퍼 사용자 암호 변경을 지원하지 않습니다. client을 사용하여 수동으로 변경해야 합니다.

연결 문자열 사용

ConnectionStrings 구성 섹션에서 연결 문자열을 사용하는 경우 builder.AddMilvusClient()호출할 때 연결 문자열의 이름을 제공할 수 있습니다.

builder.AddMilvusClient("milvus");

그런 다음 ConnectionStrings 구성 섹션에서 연결 문자열을 검색합니다.

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

기본적으로 MilvusClient gRPC API 엔드포인트를 사용합니다.

구성 공급자 사용

.NET Aspire Milvus Client 통합은 Microsoft.Extensions.Configuration을 지원합니다. Aspire:Milvus:Client 키를 사용하여 구성에서 MilvusSettings 로드합니다. 다음의 appsettings 예제를 고려해 보세요. 몇 가지 옵션을 구성하는json.

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

인라인 대리자 사용

또한 Action<MilvusSettings> configureSettings 대리자를 전달하여 코드에서 API 키를 설정하는 등 일부 또는 모든 옵션을 인라인으로 설정할 수 있습니다.

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

건강 검사

기본적으로 .NET.NET Aspire 통합을 사용하면 모든 서비스에 대해 상태 검사를 수 있습니다. 자세한 내용은 .NET.NET Aspire 통합 개요참조하세요.

.NET Aspire Milvus 데이터베이스 통합은 구성된 client를 사용하여 HealthAsync을 수행합니다. 결과 정상이면 상태 검사가 정상으로 간주되고 그렇지 않으면 비정상입니다. 마찬가지로 예외가 있는 경우, 오류가 상태 검사 실패를 통해 전파되어 상태 검사가 비정상으로 간주됩니다.

관찰 가능성 및 원격 분석

.NET .NET Aspire 통합은 로깅, 추적 및 메트릭 구성을 자동으로 설정하며, 이는 종종 관찰성의 기둥 이라고 불리기도 한다. 통합 관찰 가능성 및 원격 분석에 대한 자세한 내용은 .NET.NET Aspire 통합 개요참조하세요. 지원 서비스에 따라 일부 통합은 이러한 기능 중 일부만 지원할 수 있습니다. 예를 들어 일부 통합은 로깅 및 추적을 지원하지만 메트릭은 지원하지 않습니다. 구성 섹션에 제시된 기술을 사용하여 원격 분석 기능을 사용하지 않도록 설정할 수도 있습니다.

로깅

.NET Aspire Milvus 데이터베이스 통합은 표준 .NET 로깅을 사용하며 다음 범주의 로그 항목을 볼 수 있습니다.

Milvus.Client

다음을 통해 공유