Atlas の Aggregation Pipeline Builder を使用すると、コレクションまたはビューからのドキュメントを処理し、計算された結果を返す集計パイプライン を作成できます。
このタスクについて
Atlas は、集計パイプラインを作成するためのさまざまなモードを提供します。
Stage View Mode は、選択したステージに基づいてパイプライン構文をプリロードするビジュアルパイプラインエディタです。
Stage Wizard は Stage View Mode の機能で、シンプルな集計ステージのユースケース用のテンプレートセットを提供します。Stage Wizard には、集計パイプラインを初めて使う際に役立つ簡単なユースケースのみが含まれています。
Focus Mode は、一度に 1 つのパイプラインステージを編集するステージビューモードの機能です。Focus Mode は、複雑な、または深くネストされた集計パイプライン ステージを管理するのに役立ちます。
Text View Mode は、生のパイプライン構文を受け入れるテキストベースのパイプライン エディターです。
始める前に
集計パイプラインをビルドするには、コレクションを選択して Aggregationsタブをクリックします。Atlas に空白の集計パイプラインが表示されます。Preview of Documents in the Collection セクションには、選択したコレクションからランダムにサンプリングされた 10 ドキュメントが表示されます。
注意
MongoDB Search ステージ
Atlas でホストされているMongoDBデプロイに接続すると、Atlas 専用ステージ $search と $searchMeta が 集計パイプラインビルダで利用できるようになります。これらのステージを使用して、Atlas コレクションで 全文検索を 実行します。
手順
集約パイプラインの作成方法を見るには、選択したビューモードに対応するタブを選択します。
Atlas で、プロジェクトの Data Explorer ページに移動します。
まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。
サイドバーで、 Database見出しの下のData Explorerをクリックします。
Data Explorer が表示されます。
重要: クラスターの名前をクリックしてCluster サイドバーを開き、Data Explorer 見出しの下のShortcuts をクリックすることもできます。
Atlas で、プロジェクトの Data Explorer ページに移動します。
まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。
サイドバーで、 Database見出しの下のData Explorerをクリックします。
Data Explorer が表示されます。
重要: クラスターの名前をクリックしてCluster サイドバーを開き、Data Explorer 見出しの下のShortcuts をクリックすることもできます。
パイプライン ステージを入力します
選択したステージのフォームに入力し、Apply をクリックします。Apply をクリックすると、フォームはステージ カードに変わり、ステージ ビュー モード、フォーカス モード、またはテキスト ビュー モードで編集できるようになります。
Atlas は、ステージ出力に最大 10 個のサンプル出力ドキュメントを入力します。
注意
ステージ ウィザードを使用して既存のステージを編集することはできません。ステージ ウィザードでは新しいステージしか追加できません。既存のステージを編集するには、ステージ ビュー モード、フォーカス モード、またはテキスト ビュー モードを使用します。
Atlas で、プロジェクトの Data Explorer ページに移動します。
まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。
サイドバーで、 Database見出しの下のData Explorerをクリックします。
Data Explorer が表示されます。
重要: クラスターの名前をクリックしてCluster サイドバーを開き、Data Explorer 見出しの下のShortcuts をクリックすることもできます。
集計パイプライン ステージを選択します
Selectドロップダウン メニューをクリックし、パイプラインの最初のステージに使用する集計パイプラインライン ステージ を選択します。
Atlas で、プロジェクトの Data Explorer ページに移動します。
まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。
サイドバーで、 Database見出しの下のData Explorerをクリックします。
Data Explorer が表示されます。
重要: クラスターの名前をクリックしてCluster サイドバーを開き、Data Explorer 見出しの下のShortcuts をクリックすることもできます。
集計パイプラインを入力します
有効な集計構文をテキストエディタに入力します。テキストエディターは、正しい構文とデバッグ情報のためのリアルタイム リンティングを提供します。
テキスト ビュー モードを使用して、パイプラインをテキストエディターに入力または貼り付けることで、プレーンテキストから集計パイプラインをインポートすることもできます。
たとえば、次のパイプラインはクエリ結果を 4 つのドキュメントに制限します。
[ { "$limit" : 4 } ]
注意
プレビュー結果のすべての埋め込みフィールドと埋め込みドキュメントを展開するには、Output Options をクリックして Expand all fields を選択します。
