Atlas Search と Vector Search インデックス

Overview

このガイドでは、Atlas Search およびベクトル検索インデックス を作成および管理する方法を学習できます。これらのインデックスを使用すると、次の機能を使用できます。

• Atlas Search : 高速で全文検索を実行

• Atlas ベクトル検索 :ベクトル埋め込みでセマンティック（類似性）検索を実行

Atlas Search およびベクトル検索インデックスは、インデックスフィールドを指定し、これらのフィールドにインデックスを作成する方法を指定し、その他のオプションの構成を設定します。

このガイドでは、次のアクションを実行して Atlas Search およびベクトル検索インデックスを管理する方法について説明します。

• 検索インデックスモデルの作成

• 検索インデックスを作成

• 複数の検索インデックスの作成

• 検索インデックスをリストする

• 検索インデックスをアップデートする

• 検索インデックスを削除する

検索インデックスモデルの作成

Atlas Search またはベクトル検索インデックスを作成するには、まずインデックス仕様を設定する CreateSearchIndexModelインスタンスを構築する必要があります。

CreateSearchIndexModel には次のプロパティがあります。

Atlas Search フィールド マッピングの詳細については、Atlas ドキュメントの「フィールド マッピングの定義」を参照してください。

Atlas ベクトル検索インデックスの定義の詳細については、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 またはベクトル検索インデックスを作成できます。このメソッドは、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 とベクトル検索インデックスを作成できます。このメソッドは、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

検索インデックスをリストする

コレクションの既存の Atlas Search 検索インデックスと Vector Search 検索インデックスに関する情報にアクセスするには、コレクションで SearchIndexes.List() メソッドを呼び出します。

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": [...] }

検索インデックスをアップデートする

Atlas Search またはベクトル検索インデックスを更新するには、IMongoCollectionインスタンスで SearchIndexes.Update() メソッドを呼び出します。このメソッドは次のパラメーターを受け入れます:

• 更新するインデックスの名前

• 変更されたインデックス定義ドキュメント

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

検索インデックスを削除する

Atlas Search またはベクトル検索インデックスを削除するには、IMongoCollectionインスタンスで SearchIndexes.DropOne() メソッドを呼び出します。このメソッドは、削除するインデックスの名前をパラメータとして受け入れます。

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 クイック スタート

• クエリ結果の精度を測定する方法