クエリの作成

Atlas 検索クエリを作成します。

1. 集計パイプライン ステージを選択します。

   使用する集計パイプライン ステージに対応するタブを選択します。

   $search

   $searchMeta

   $search 集計パイプラインを使用して、クエリに一致するデータのインデックス付きフィールドに対して全文検索を実行できます。

   {
      $search: {
         "index": "<index-name>",
         ...
      }
   }

   $searchMeta 集計パイプライン ステージを使用して、検索結果に関するメタデータを返すことができます。

   {
      $searchMeta: {
         "index": "<index-name>",
         ...
      }
   }

   詳しくは、 「 集計パイプライン ステージの選択 」を参照してください。

2. 演算子を指定します。

   コレクションに対して特定の検索を実行するには、1 つ以上の演算子またはコレクターを選択します。

   $search

   $searchMeta

   {
      $search: {
         "index": "<index-name>",
         "<operator-name>": {
         <operator-specifications>
         },
      }
   }

   {
      $searchMeta: {
         "index": "<index-name>",
         "<operator-name>"|"<collector-name>": {
            <operator-specifications>|<collector-specifications>
         }
      }
   }

   詳しくは、「 Atlas Search クエリでの演算子とコレクターの使用 」を参照してください。

3. （任意）Atlas 検索クエリに関する追加情報を取得します。

   $search

   $searchMeta

   1 つまたは複数のオプションを指定して、MongoDB Atlas Search の検索クエリ結果を調整します。

   {
      $search: {
         "index": "<index-name>",
         "<operator-name>": {
            <operator-specifications>
         },
         "highlight": {
            <highlight-options>
         }
      }
   }

   検索結果は、次の方法でカスタマイズできます。

   オプション	ユースケース
   score	Atlas Search が関連する結果を返すように、結果内のドキュメントの score を変更します。
   scoreDetail	Atlas Search が返す各ドキュメントのスコアの詳細な内訳を取得します。
   highlight	検索タームを元に表示する クエリ結果のフィールドとして表示されるコンテキスト。
   explain	Atlas Search がクエリの条件を満たすために実行した Lucene クエリと、クエリを実行するさまざまな段階で費やした時間に関する情報と実行統計を取得します。
   returnStoredSource	Atlas 検索クエリをより効率的に実行するには、コレクションの Atlas Search インデックス定義で指定された mongot に保存されているフィールドのみを取得します。
   count	Atlas 検索クエリの検索結果の件数を表示します。
   sort	Atlas Search の検索クエリ結果を、数値フィールド、文字列フィールド、日付フィールド、およびスコアで並べ替えます。

   Atlas 検索クエリとともに、結果結果の件数などのメタデータを返します。

   {
      $searchMeta: {
         "index": "<index-name>",
         "<operator-name>": {
            <operator-specifications>
         },
         "count": {
            <count-options>
         }
      }
   }

   詳しくは、「追加の検索オプションの定義 」を参照してください。

Atlas 検索クエリを実行します。

MongoDB Atlas 検索クエリ構文を確認し、ドライバー、 mongosh、 Compass、またはSearch Tester を使用してアプリケーション上で実行します。