Docs Menu
Docs Home
/
MongoDB Atlas
/
データのやり取り

集計パイプラインを実行する

項目一覧

  • 必須のロール
  • 集計パイプライン ビルダーへのアクセス
  • 集計パイプラインを作成する
  • 集計パイプラインをドライバー言語でエクスポートする
  • 集計パイプライン設定を構成する

Atlas UI を使用して、集計パイプラインをビルドし、データを処理できます。集計パイプラインは、選択された パイプライン ステージ に基づいて、ドキュメントを集計された結果に変換します。

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

必須のロール

Atlas UI で集計パイプラインを作成して実行するには、Project Data Access Read Only 以上のロールが必要です。

パイプラインで $out ステージを利用するには、Project Data Access Read/Write ロールが必要です。

集計パイプライン ビルダーへのアクセス

1

コレクションのデータベースを選択します。

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

Atlas UI でデータベースを強調表示するスクリーンショット。
クリックして拡大します
2

左側またはメイン パネルでコレクションを選択します。

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

3

[] ビューを選択します。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Aggregation

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

集計パイプライン ビルダーの最初のビュー。
クリックして拡大します

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

1

集計ステージを選択します。

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

パイプライン ステージの選択を示すスクリーンショット。
クリックして拡大します

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

2

集計ステージを入力してください。

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

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

書き込みステージを含まない集計パイプライン（$out や $merge など）には、デフォルトで出力を 10 ドキュメントに制限する $limit ステージが自動的に末尾に追加されます。$limit ステージで許可されるドキュメントの数を変更するには、集計パイプライン設定 で Number of Preview Documents の値フィールドを更新します。

パイプライン ステージの結果を示すスクリーンショット。
クリックして拡大します
3

必要に応じて、パイプラインにステージを追加します。

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

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

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

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

パイプライン ステージを削除するには、目的のステージで Delete をクリックします。

4

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

照合

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

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

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

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

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

テキストからの集計パイプラインをインポートする

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

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

1

ダイアログ ボックスを開きます。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">New Pipeline from Text

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

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

    テキスト ダイアログ ボックスから新しいパイプラインを開くスクリーンショット。
    クリックして拡大します
2

ダイアログ ボックスにパイプラインを入力または貼り付けます。

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

3

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Create New

4

Confirm次に表示されるダイアログ ボックスで [] をクリックします。

パイプラインをリセットする

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

集計パイプラインをドライバー言語でエクスポートする

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

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

1

集計パイプラインを構築します。

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

2

パイプラインExport to Language ビルダの上部にある [] をクリックします。

3

希望のエクスポート言語を選択します。

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

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

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

4

必要に応じて、import ステートメントを含めます。

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

5

Copyボタンをクリックします。

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

6

Close集計パイプライン ビルダに戻るには、[] をクリックします。

集計パイプライン設定を構成する

Atlas UI で集計パイプライン設定を構成できます。

制限

Atlas では、次のステージのプレビューの入力ドキュメントの数を 100,000 に制限しています。

この制限により、プレビューの実行速度が向上します。Atlas はパイプラインの実行時に制限を適用しません。

Atlas UI ではプレビュー入力ドキュメントの制限を変更できません。Compass を使用して入力ドキュメントの制限を変更するには、「集計パイプラインビルダーの設定」を参照してください。

集計パイプライン設定を変更する

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

1

パイプライン ビルダの右上にある アイコンをクリックします。

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

必要に応じてパイプライン設定を変更します。

Atlas UI では、次の設定を変更できます。

設定
説明
default
Comment Mode

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

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

On
Number of Preview Documents

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

各ステージでプレビューできるドキュメントは最大 20 件のみです。

10
3

Apply変更を保存するには、[] をクリックします。

戻る

Indexes

次へ

トリガー