AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

集計パイプラインを作成する

MongoDB Compass の集計パイプライン ビルダを使用すると、コレクションまたはビューからのドキュメントを処理し、計算された結果を返す集計パイプラインを作成できます。

MongoDB Compass は、集計パイプラインを作成するためのさまざまなモードを提供します。

  • Stage View Mode は、選択したステージに基づいてパイプライン構文をプリロードするビジュアルパイプラインエディタです。

  • Stage Wizard は Stage View Mode の機能で、シンプルな集計ステージのユースケース用のテンプレートセットを提供します。Stage Wizard には、集計パイプラインを初めて使う際に役立つ簡単なユースケースのみが含まれています。

  • Focus Mode は、一度に 1 つのパイプラインステージを編集するステージビューモードの機能です。Focus Mode は、複雑な、または深くネストされた集計パイプライン ステージを管理するのに役立ちます。

  • Text View Mode は、生のパイプライン構文を受け入れるテキストベースのパイプライン エディターです。

集計パイプラインをビルドするには、コレクションを選択して Aggregations タブをクリックします。Compass に空白の集計パイプラインが表示されます。Preview of Documents in the Collection セクションには、選択したコレクションからランダムにサンプリングされた 10 個のドキュメントが表示されます。

注意

Atlas Search ステージ

Atlas でホストされているMongoDBデプロイに接続すると、Atlas 専用ステージ $search と $searchMeta が 集計パイプラインビルダで利用できるようになります。これらのステージを使用して、Atlas コレクションで 全文検索を 実行します。

集約パイプラインの作成方法を見るには、選択したビューモードに対応するタブを選択します。

1

集計パイプライン ペインで、{} Stagesトグル スイッチが選択されていることを確認します。

2

集計パイプライン ペインの下部にある + Add Stage ボタンをクリックします。

3

集計ステージ カードの左上隅にある Selectドロップダウン メニューをクリックし、パイプラインの最初のステージに使用する集計パイプライン ステージを選択します。

4

選択したステージを入力します。パイプライン ステージの境界を右にドラッグすると、パイプライン ステージの幅を調整できます。

注意

各パイプラインステージ名の右側にあるトグルで、そのステージをパイプラインに含めるかどうかを設定します。パイプラインステージを切り替えることによってパイプラインプ レビューもアップデートされ、プレビューはそのステージが含まれているかどうかに基づいてアップデートされます。

例、次のパイプラインでは最初の $match ステージが除外され、 $project ステージのみが含まれます。

Aggregation Builder の除外ステージの例
5

最後の集計ステージの後にパイプライン ステージを追加するには、Add Stage をクリックします。最後に追加したステージの前に集計ステージを追加するには、ステージ カードの上にある + アイコンをクリックします。

追加のステージごとにステップ 3 と 4 を繰り返します。

注意

パイプラインステージの順序を変更するには、各ステージ カードのヘッダーをドラッグします。

6

パイプライン ビルダの右上隅にある Run をクリックします。Compass は、ドキュメント ビューに結果を返します。

警告

$mergeや$outなどの一部の集計演算子は、コレクションのデータを変更する可能性があります。

集計パイプラインにコレクションのデータを変更できる演算子が含まれている場合は、パイプラインを実行する前に確認のためのプロンプトが表示されます。