/ /

/ /

MongoDB\Database::aggregate()

バージョン1.5の新機能。

定義

MongoDB\Database::aggregate()

Runs a specified admin/diagnostic pipeline which does not require an underlying collection. For aggregations on collection data, see MongoDB\Collection::aggregate().

function aggregate(
    array $pipeline,
    array $options = []
): Traversable

パラメーター

$pipeline : 配列

集計パイプライン操作を指定します。

$options : 配列

必要なオプションを指定する配列。

名前	タイプ	説明
allowDiskUse	ブール値	一時ファイルへの書込みを有効にします。 `true`に設定すると、集計ステージは`dbPath`ディレクトリの`_tmp`サブディレクトリにデータを書込むことができます。
batchSize	integer	クエリ結果で返される各バッチする内のドキュメントの最大数。デフォルトでは、`aggregate` コマンドの初期バッチするサイズは `101` ドキュメントで、後続の各バッチするの最大サイズは 16 メビバイト（MiB）です。このオプションを使用すると、16 MiB より小さい制限が適用できますが、超えることはありません。`batchSize` を、バッチが 16 MiB を超える制限に設定している場合、このオプションは効果がありません。 BatchSize が `0` の場合、カーソルは作成されますが、最初のバッチするではドキュメントは返されません。これは、サーバー側での目立った作業なしに、`aggregate` からのカーソルやエラーをすばやく返すのに役立つ場合があります。
bypassDocumentValidation	ブール値	`true`の場合、書込み操作によってドキュメントレベルの検証を回避できます。デフォルトは`false`です。これは、 $ out ステージと$outステージを使用する場合にのみ適用されます。
コーデック	MongoDB\Codec\DocumentCodec	ドキュメントのエンコードまたはデコードに使用するタイプコーデックでデータをエンコードする。このオプションは `typeMap` オプションと相互に排他的です。バージョン1.17の新機能。
collation	array\|object	Collation allows users to specify language-specific rules for string comparison, such as rules for lettercase and accent marks. When specifying collation, the `locale` field is mandatory; all other collation fields are optional. For descriptions of the fields, see Collation Document.
comment	混合	データベースプロファイラ、 currentOp出力、およびログから操作を追跡するのに役立つ任意のコメントを指定できるようにします。コメントには、サーバーバージョン 4.4 以上の有効な BSON タイプであればどれでもかまいません。以前のサーバーバージョンでは string 値のみがサポートされていました。
explain	ブール値	パイプラインの処理に関する情報を返すかどうかを指定します。
hint	string\|array\|object	使用するインデックス。インデックス名を string またはインデックスキーパターンをドキュメントとして指定します。指定すると、クエリシステムはヒント指定したインデックスを使用するプランのみを考慮します。
let	array\|object	パラメーター名と値のマップ。値は、ドキュメントフィールドを参照しない定数または閉じた式である必要があります。その後、パラメーターには集計式コンテキストで変数としてアクセスできます（例: `$$var` ）。これは 5.0 より前のサーバーバージョンではサポートされていないため、使用された場合は実行時に例外が発生します。バージョン1.9の新機能。
maxTimeMS	integer	カーソルに対する情報処理操作の累積時間制限（ミリ秒単位）。MongoDB は、割り込みポイントの後の最も早く操作を中止します。
ReadConcern	MongoDB\Driver\ReadConcern	操作に使用する読み取り保証。デフォルトは、データベースの読み取り保証 (read concern) です。
readPreference	MongoDB\Driver\ReadPreference	操作に使用する読み取り設定。データベースの読み込み設定（read preference）がデフォルトで設定されます。
セッション	MongoDB\Driver\Session	操作に関連付けるクライアントセッション。
typeMap	配列	The type map to apply to cursors, which determines how BSON documents are converted to PHP values. Defaults to the database's type map.
writeConcern	MongoDB\Driver\WriteConcern	操作に使用する書込み保証 ( write concern )。データベースの書込み保証 (write concern) のデフォルト。

Return Values

MongoDB\Driver\Cursor または ArrayIteratorオブジェクト。どちらの場合も、戻り値は Triggers になります。

エラーと例外

MongoDB\Exception\UnexpectedValueException サーバーからのコマンド応答が不正な形式であった場合、。

MongoDB\Exception\UnsupportedExceptionオプションが使用され、選択したサーバーでサポートされていない場合（例: collation 、 readConcern 、 writeConcern ）。

MongoDB\Exception\InvalidArgumentException は、パラメータまたはオプションの解析に関連するエラーの場合はです。

MongoDB$Driver\Exception\RuntimeException は、拡張レベルの他のエラーの場合（例:）。

例

次の集計の例では、 $currentOp集計パイプラインステージを使用して実行中のすべてのコマンドを一覧表示し、このリストをフィルタリングして実行中のコマンド操作のみを表示します。

<?php
$database = (new MongoDB\Client)->admin;
$cursor = $database->aggregate(
    [
        ['$currentOp' => []],
        ['$match' => ['op' => 'command']],
    ]
);

その他の参照

MongoDB\Collection::aggregate()
集計コマンド参照（MongoDB マニュアル）
MongoDB マニュアルの集計パイプラインに関するドキュメント

戻る

__get()

command()