Atlas Search 및 Vector Search 인덱스

개요

이 가이드에서는 Atlas Search 및 Vector Search 인덱스를 만들고 관리 방법을 학습 수 있습니다. 이러한 인덱스를 통해 다음 기능을 사용할 수 있습니다.

• Atlas Search: 빠른 전체 텍스트 검색 수행

• Atlas Vector Search: 벡터 임베딩에 대한 시맨틱(유사성) 검색 수행

Atlas Search 및 Vector Search 인덱스는 인덱스 할 필드를 지정하고, 이러한 필드를 인덱싱하는 방법을 지정하고, 기타 선택적 구성을 설정하다 .

이 가이드 다음 조치를 수행하여 Atlas Search 및 Vector Search 인덱스를 관리 방법에 대해 설명합니다.

• 검색 인덱스 모델 만들기

• 검색 인덱스 만들기

• 다중 검색 인덱스 만들기

• 검색 인덱스 나열

• 검색 인덱스 업데이트

• 검색 인덱스 삭제

검색 인덱스 모델 만들기

Atlas Search 또는 Vector Search 인덱스 만들려면 먼저 인덱스 사양을 설정하는 CreateSearchIndexModel 인스턴스 빌드 해야 합니다.

CreateSearchIndexModel 에는 다음과 같은 속성이 있습니다.

Atlas Search 필드 매핑에 대해 자세히 알아보려면 Atlas 설명서에서 필드 매핑 정의 를 참조하세요.

Atlas Vector Search 인덱스 정의에 대해 자세히 학습하려면 Atlas 설명서에서 벡터 검색을 위한 필드를 인덱싱하는 방법 을 참조하세요.

var def = new BsonDocument {
  { "mappings", new BsonDocument {
      { "dynamic", false },
      { "fields", new BsonDocument {
        { "title", new BsonDocument { {"type", "string" } } },
        { "released", new BsonDocument { { "type", "date" } } } } }
  } }
};
var indexModel = new CreateSearchIndexModel(
  "search_idx",
  SearchIndexType.Search,
  def
);

var def = new BsonDocument
{
    { "fields", new BsonArray
        {
            new BsonDocument
            {
                { "type", "vector" },
                { "path", "plot_embedding" },
                { "numDimensions", 1536 },
                { "similarity", "euclidean" }
            }
        }
    }
};
var indexModel = new CreateSearchIndexModel(
  "vs_idx",
  SearchIndexType.VectorSearch,
  def
);

검색 인덱스 만들기

IMongoCollection 인스턴스 에서 SearchIndexes.CreateOne() 메서드를 호출하여 컬렉션 에 Atlas Search 또는 Vector Search 인덱스 만들 수 있습니다. 이 메서드는 CreateSearchIndexModel 인스턴스 에 지정된 인덱스 모델을 매개 변수로 허용합니다.

var indexModel = new CreateSearchIndexModel(
  "example_index",
  SearchIndexType.Search,
  new BsonDocument {
    { "mappings", new BsonDocument {
      { "dynamic", true },
    } }
  }
);
var result = movieCollection.SearchIndexes.CreateOne(indexModel);
Console.WriteLine("Created Atlas Search index:\n{0}", result);

Created Atlas Search index:
"example_index"

다중 검색 인덱스 만들기

IMongoCollection 인스턴스 에서 SearchIndexes.CreateMany() 메서드를 호출하여 여러 개의 Atlas Search 및 Vector Search 인덱스를 만들 수 있습니다. 이 메서드는 CreateSearchIndexModel 인스턴스의 IEnumerable 를 매개 변수로 허용합니다.

var searchModel = new CreateSearchIndexModel(
  "as_idx",
  SearchIndexType.Search,
  new BsonDocument {
    { "mappings", new BsonDocument {
      { "dynamic", true },
    } }
  }
);
var vectorModel = new CreateSearchIndexModel(
  "vs_idx",
  SearchIndexType.VectorSearch,
  new BsonDocument
  {
      { "fields", new BsonArray
          {
              new BsonDocument
              {
                  { "type", "vector" },
                  { "path", "plot_embedding" },
                  { "numDimensions", 1536 },
                  { "similarity", "euclidean" }
              }
          }
      }
  }
);
var models = new List<CreateSearchIndexModel> { searchModel, vectorModel };
var indexes = movieCollection.SearchIndexes.CreateMany(models);
Console.WriteLine("Created Search indexes:\n{0} {1}", indexes.ToArray());

Created Search indexes:
as_idx vs_idx

검색 인덱스 나열

컬렉션에서 SearchIndexes.List() 메서드를 호출하여 컬렉션의 기존 Atlas Search 및 Vector Search 인덱스에 대한 정보에 액세스할 수 있습니다.

var indexesList = movieCollection.SearchIndexes.List().ToList();
foreach (var i in indexesList)
{
  Console.WriteLine(i);
}

{ "id": "...", "name": "as_idx", "status": "READY", "queryable":
true, "latestDefinitionVersion": {...}, "latestDefinition": {
"mappings": { "dynamic": true } }, "statusDetail": [...] }
{ "id": "...", "name": "vs_idx", "type": "vectorSearch", "status":
"READY", "queryable": true, ..., "latestDefinition": { "fields": [{
"type": "vector", "path": "plot_embedding", "numDimensions": 1536,
"similarity": "euclidean" }] }, "statusDetail": [...] }

검색 인덱스 업데이트

IMongoCollection 인스턴스 에서 SearchIndexes.Update() 메서드를 호출하여 Atlas Search 또는 Vector Search 인덱스 업데이트 할 수 있습니다. 이 메서드는 다음 매개변수를 허용합니다:

• 업데이트할 인덱스의 이름

• 수정된 인덱스 정의 문서

var updatedDef = new BsonDocument
{
    { "fields", new BsonArray
        {
            new BsonDocument
            {
                { "type", "vector" },
                { "path", "plot_embedding" },
                { "numDimensions", 1536 },
                { "similarity", "dotProduct" }
            }
        }
    }
};
movieCollection.SearchIndexes.Update("vs_index", updatedDef);

검색 인덱스 삭제

IMongoCollection 인스턴스 에서 SearchIndexes.DropOne() 메서드를 호출하여 Atlas Search 또는 Vector Search 인덱스 삭제 수 있습니다. 이 메서드는 삭제 인덱스 의 이름을 매개 변수로 받습니다.

movieCollection.SearchIndexes.DropOne("example_index");

추가 정보

.NET/ C# 드라이버 사용하여 만들 수 있는 다른 인덱스에 대해 학습하려면 인덱스 만들기 및 관리 가이드를 참조하세요.

Atlas Search에 대해 자세히 알아보려면 다음 Atlas 설명서를 참조하세요.

• Atlas Search 모범 사례

• Atlas Search 성능 조정

• Atlas Search M0, M2 및 M5 제한 사항

• FAQ: Atlas Search

Atlas Vector Search에 대해 자세히 알아보려면 다음 Atlas 문서를 참조하세요.

• 벡터 검색 성능 개선하기

• Atlas Vector Search 빠른 시작

• 쿼리 결과의 정확성을 측정하는 방법