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

포함: 호스팅 통합 및 Client 통합

Milvus 대규모 벡터 데이터를 효율적으로 저장, 인덱싱 및 검색하는 오픈 소스 벡터 데이터베이스 시스템입니다. 기계 학습, 인공 지능 및 데이터 과학 애플리케이션에 일반적으로 사용됩니다.

벡터 데이터는 정보를 숫자 또는 좌표의 배열인 수학 벡터로 인코딩합니다. 기계 학습 및 AI 시스템은 종종 벡터를 사용하여 이미지, 텍스트, 오디오 또는 비디오와 같은 구조화되지 않은 개체를 나타냅니다. 벡터의 각 차원은 개체의 특정 특성을 설명합니다. 이를 비교하여 시스템은 개체 클러스터를 분류, 검색 및 식별할 수 있습니다.

이 문서에서는 .NET AspireMilvus 데이터베이스 통합을 사용하는 방법을 알아봅니다. .NET Aspire Milvus 데이터베이스 통합을 사용하면 기존 Milvus 데이터베이스에 연결하거나 milvusdb/milvus 컨테이너 이미지사용하여 새 인스턴스를 만들 수 있습니다.

호스팅 통합

Milvus 데이터베이스 호스팅 통합은 서버를 MilvusServerResource 형식으로, 데이터베이스를 MilvusDatabaseResource 형식으로 모델화합니다. 이러한 형식 및 API에 액세스하려면 📦Aspire.호스팅.Milvus NuGet 패키지를 앱 호스트 프로젝트에 추가해야 합니다.

dotnet add package Aspire.Hosting.Milvus

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

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

Milvus 서버 및 데이터베이스 리소스 추가

앱 호스트 프로젝트에서 AddMilvus을(를) 호출하여 Milvus 리소스 빌더를 추가하고 반환합니다. 반환된 리소스 빌더에 호출을 연결하여 AddDatabase에 Milvus 데이터베이스 리소스를 추가합니다.

var builder = DistributedApplication.CreateBuilder(args);

var milvus = builder.AddMilvus("milvus")
                    .WithLifetime(ContainerLifetime.Persistent);

var milvusdb = milvus.AddDatabase("milvusdb");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(milvusdb)
       .WaitFor(milvusdb);

// After adding all resources, run the app...

.NET .NET Aspire milvusdb/milvus 이미지와 함께 이전 예제와 같이 앱 호스트에 컨테이너 이미지를 추가하면 로컬 컴퓨터에 새 Milvus 인스턴스가 만들어집니다. Milvus 리소스 작성기(milvus 변수)에 대한 참조는 데이터베이스를 추가하는 데 사용됩니다. 데이터베이스는 milvusdb으로 명명되고 ExampleProject에 추가됩니다.

WithReference 메서드는 ExampleProject에 있는 이름이 milvusdb인 연결을 구성합니다.

자격 증명 처리 및 Milvus 리소스에 대한 다른 매개 변수 전달

Milvus 리소스에는 usernameroot 및 암호 Milvus가 포함된 기본 자격 증명이 있습니다. Milvus 환경 변수 COMMON_SECURITY_DEFAULTROOTPASSWORD사용하여 구성 기반 기본 암호를 지원합니다. 컨테이너의 기본 암호를 변경하려면 apiKey 호스팅 API를 호출할 때 AddMilvus 매개 변수를 전달합니다.

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

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

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

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

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

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

데이터 볼륨을 사용하여 Milvus 리소스 추가

Milvus 서비스 리소스에 데이터 볼륨을 추가하려면 WithDataVolume 리소스에서 Milvus 메서드를 호출합니다.

var builder = DistributedApplication.CreateBuilder(args);

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

var milvusdb = milvus.AddDatabase("milvusdb");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(milvusdb)
       .WaitFor(milvusdb);

// After adding all resources, run the app...

데이터 볼륨은 컨테이너의 수명 주기 외부에서 Milvus 데이터를 유지하는 데 사용됩니다. 데이터 볼륨은 /var/lib/milvus 컨테이너의 SQL Server 경로에 탑재되고 name 매개 변수가 제공되지 않으면 이름이 임의로 생성됩니다. 데이터 볼륨 및 바인딩 탑재보다 선호되는 이유에 대한 자세한 내용은 문서: 볼륨을 참조하세요.

데이터 바인드 마운트를 사용하여 Milvus 리소스를 추가

Milvus 리소스에 데이터 바인딩 탑재를 추가하려면 WithDataBindMount 메서드를 호출합니다.

var builder = DistributedApplication.CreateBuilder(args);

var milvus = builder.AddMilvus("milvus")
                    .WithDataBindMount(source: @"C:\Milvus\Data");

var milvusdb = milvus.AddDatabase("milvusdb");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(milvusdb)
       .WaitFor(milvusdb);

// After adding all resources, run the app...

데이터 바인드 마운트는 호스트 머신의 파일 시스템을 사용하여 컨테이너 재시작 시 Milvus 데이터를 영구적으로 저장합니다. 데이터 바인드 마운트는 Milvus 컨테이너에서 호스트 머신의 Windows(C:\Milvus\Data) 경로(또는 /Milvus/Data의 Unix)에 마운트됩니다. 데이터 바인드 마운트에 대한 자세한 내용은 Docker 문서: 바인드 마운트를 참조하세요.

Attu 리소스 만들기

Attu GUI(그래픽 사용자 인터페이스) 및 Milvus 데이터베이스와 상호 작용하도록 설계된 관리 도구입니다. 여기에는 벡터 데이터를 조사하고 이해하는 데 도움이 되는 다양한 시각화 기능이 포함되어 있습니다.

Attu를 사용하여 Milvus 솔루션에서 .NET Aspire 관리하려면 WithAttu 리소스에서 Milvus 확장 메서드를 호출합니다. 메서드는 zilliz/attu 이미지컨테이너를 만듭니다.

var builder = DistributedApplication.CreateBuilder(args);

var milvus = builder.AddMilvus("milvus")
                    .WithAttu()
                    .WithLifetime(ContainerLifetime.Persistent);

var milvusdb = milvus.AddDatabase("milvusdb");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(milvusdb)
       .WaitFor(milvusdb);

// After adding all resources, run the app...

.NET .NET Aspire 솔루션을 디버그하면 솔루션의 리소스에 나열된 Attu 컨테이너가 표시됩니다. 리소스의 엔드포인트를 선택하여 GUI를 열고 데이터베이스 관리를 시작합니다.

Client 통합(미리 보기)

.NET Aspire Milvus 클라이언트 통합을 시작하려면 📦Aspire설치합니다.Milvus. 클라이언트 사용 프로젝트에서 NuGet 패키지를Client, 즉 Milvus 데이터베이스 클라이언트를 사용하는 애플리케이션에 대한 프로젝트입니다. Milvus 클라이언트 통합은 Milvus.Client.MilvusClient 인스턴스를 등록하며, 이를 통해 Milvus 데이터베이스와 상호 작용할 수 있습니다.

dotnet add package Aspire.Milvus.Client

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

Milvus 클라이언트 추가

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

builder.AddMilvusClient("milvusdb");

그런 다음 종속성 주입을 사용하여 MilvusClient 인스턴스를 검색할 수 있습니다. 예를 들어 예제 서비스에서 연결을 검색하려면 다음을 수행합니다.

public class ExampleService(MilvusClient client)
{
    // Use the Milvus Client...
}

종속성 주입에 대한 자세한 내용은 .NET 종속성 주입참조하세요.

키 지정 Milvus 클라이언트 추가

여러 MilvusClient 인스턴스를 서로 다른 연결 이름으로 등록하려는 경우가 있을 수 있습니다. 키 Milvus 클라이언트를 등록하려면 AddKeyedMilvusClient 메서드를 호출합니다.

builder.AddKeyedMilvusClient(name: "mainDb");
builder.AddKeyedMilvusClient(name: "loggingDb");

그런 다음 종속성 주입을 사용하여 MilvusClient 인스턴스를 검색할 수 있습니다. 예를 들어 예제 서비스에서 연결을 검색하려면 다음을 수행합니다.

public class ExampleService(
    [FromKeyedServices("mainDb")] MilvusClient mainDbClient,
    [FromKeyedServices("loggingDb")] MilvusClient loggingDbClient)
{
    // Use clients...
}

키 지정된 서비스에 대한 자세한 내용은 .NET 종속성 주입: 키 지정된 서비스를 참조하세요.

구성

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

연결 문자열 사용

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

builder.AddMilvusClient("milvus");

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

{
  "ConnectionStrings": {
    "milvus": "Endpoint=http://localhost:19530/;Key=root:Non-default-P@ssw0rd"
  }
}

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

구성 공급자 사용

.NET Aspire Milvus 클라이언트 통합은 Microsoft.Extensions.Configuration지원합니다. MilvusClientSettings 키를 사용하여 구성에서 Aspire:Milvus:Client 로드합니다. 다음 코드 조각은 일부 옵션을 구성하는 appsettings.json 예입니다.

{
  "Aspire": {
    "Milvus": {
      "Client": {
        "Endpoint": "http://localhost:19530/",
        "Database": "milvusdb",
        "Key": "root:Non-default-P@ssw0rd",
        "DisableHealthChecks": false
      }
    }
  }
}

전체 Milvus 클라이언트 통합 JSON 스키마는 Aspire참조하세요.Milvus.Client/ConfigurationSchema.json.

인라인 대리자 사용

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

builder.AddMilvusClient(
    "milvus",
    static settings => settings.Key = "root:Non-default-P@ssw0rd");

Client 통합 상태 검사

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

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

• MilvusClientSettings.DisableHealthChecks이 false일 때, Milvus 서버에 연결을 시도하는 상태 검사를 추가합니다.
• 구성된 클라이언트를 사용하여 HealthAsync작업을 수행합니다. 결과 정상이면 상태 검사가 정상으로 간주되고 그렇지 않으면 비정상입니다. 마찬가지로 예외가 있는 경우, 오류가 상태 검사 실패를 통해 전파되어 상태 검사가 비정상으로 간주됩니다.

관찰 가능성 및 원격 분석

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

로깅

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

• Milvus.Client

추적

.NET Aspire Milvus 데이터베이스 통합은 Milvus.Client 라이브러리에서 지원되지 않으므로 현재 추적 활동을 내보내지 않습니다.

지표

.NET Aspire Milvus 데이터베이스 통합은 Milvus.Client 라이브러리에서 지원되지 않으므로 현재 메트릭을 내보내지 않습니다.

참조

• Milvus
• Milvus GitHub 리포지토리
• Milvus .NET SDK
• .NET .NET Aspire 통합
• .NET Aspire GitHub 리포지토리