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

集計パイプラインビルダー

Data Explorerは、データを処理するための集計パイプラインビルダを提供します。 集計パイプラインは、選択されたパイプライン ステージ に基づいて、ドキュメントを集計された結果に変換します。

MongoDB Atlas集計パイプラインビルダーは、パイプラインを実行するためではなく、主にパイプラインをビルドするために設計されています。パイプラインビルダーを使用すると、パイプラインをエクスポートし、クライアントライブラリで実行する簡単な方法が提供されます。

MongoDB Ops Manager UI でデータを操作するには、次のようにします。

  1. 左側のナビゲーションで [ Deployment ] をクリックします。

  2. 必要な MongoDB 配置を選択します。

  3. Data タブを選択します。

Data Explorerで集計パイプラインを作成して実行するには、少なくともProject Data Access Read Onlyロールが付与されている必要があります。

パイプラインで$outステージを利用するには、少なくともProject Data Access Read/Writeロールが付与されている必要があります。

1

メイン パネルと左側の Namespaces には、データベース内のコレクションが一覧表示されます。

2

メイン パネルには、Find、Indexes、Aggregation のビューが表示されます。

3

Aggregationビューを初めて開くと、 Data Explorerには空の集計パイプラインが表示されます。

1

左下のパネルの Select ドロップダウンから集計ステージを選択します。

ドロップダウンの右側にあるトグルで、ステージが有効かどうかを指定します。

2

ステージに適切な値を入力します。 コメントモードが有効になっている場合、パイプラインビルダは選択したステージの構文ガイドラインを提供します。

ステージを変更すると、 Data Explorerは現在のステージの結果に基づいて右側のプレビュー ドキュメントが更新されます。

3

パイプラインにステージを追加するには、次の 2 つの方法があります。

  • パイプラインの下部にある Add Stage ボタンをクリックして、パイプラインの最後に新しいステージを追加します。

  • ステージ上の ボタンをクリックすると、ボタンがクリックされたステージの直後に新しいステージが追加されます。

ステージ追加ボタンを示すスクリーンショット。

パイプライン ステージを削除するには、目的のステージ上のアイコンを表示します。

4

collat​​ion を使用して、大文字と小文字やアクセント記号のルールなど、文字列比較の言語固有のルールを指定します。

照合ドキュメントを指定するには、パイプライン ビルダーの上部にある Collation をクリックします。

照合ドキュメントには、次のフィールドがあります。

{ locale: <string>, caseLevel: <boolean>, caseFirst: <string>, strength: <int>, numericOrdering: <boolean>, alternate: <string>, maxVariable: <string>, backwards: <boolean>}

locale フィールドは必須です。その他の照合フィールドはすべてオプションです。フィールドの説明については、「照合ドキュメント」を参照してください。

集計パイプラインをプレーンテキストからパイプライン ビルダーにインポートして、パイプラインを簡単に変更および検証できます。

プレーンテキストからパイプラインをインポートするには、次の手順に従います。

1
  1. パイプライン ビルダーの上部にあるプラス アイコンの横にある矢印をクリックします。

  2. [New Pipeline from Text] をクリックします。

2

パイプラインは、db.collection.aggregate() メソッドの pipeline パラメーターの構文と一致する必要があります。

3
4

パイプラインを初期の空白の状態に戻すには、パイプライン ビルダーの上部にあるプラス アイコンをクリックします。

集計パイプラインビルダーを使用すると、完成したパイプラインを、サポートされているクライアントライブラリ言語のいずれかにエクスポートできます。 Java、Node、 C#、 Python 3。この機能を使用して、アプリケーションで使用できるようにパイプラインを形式およびエクスポートします。

集計パイプラインをエクスポートするには、次の手順に従います。

1

集計パイプラインの作成手順については、「 集計パイプラインの作成 」を参照してください。

2
3

Export Pipeline To ドロップダウンで、希望の言語を選択します。

左側の My Pipeline ペインには、パイプラインが mongosh 構文で表示されます。

右側のペインには、選択した言語でパイプラインが表示されます。

4

(任意):選択した言語に必要なインポート ステートメントを含めるには、Include Import Statements オプションをオンにします。

5

パイプラインの右上にある Copy ボタンをクリックすると、選択した言語のパイプラインがクリップボードにコピーされます。これで、パイプラインをアプリケーションに統合できるようになりました。

6

集計パイプラインビルダーの設定を変更するには、次の手順に従います。

1
パイプライン設定ボタンを示すスクリーンショット。
2

変更できる設定は次のとおりです。

設定
説明
default

Comment Mode

有効にすると、 Data Explorerは各ステージにヘルパーコメントを追加します。

この設定を変更すると、新しいステージにのみ影響し、パイプラインにすでに追加されているステージは変更されません。

On

Number of Preview Documents

各ステージのプレビューに表示するドキュメントの数。

20

3