MongoDB\Collection::count()

定義

MongoDB\Collection::count()

フィルター条件に一致するドキュメントの数をカウントします。

function count(
    array|object $filter = [],
    array $options = []
): integer

パラメーター

$filter : array|object

カウントするドキュメントを指定するフィルター条件。

$options : 配列

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

名前	タイプ	説明
collation	array|object	照合順序を指定すると、大文字や小文字、アクセント記号など、string を比較するための言語独自のルールを指定できます。 照合を指定する場合、 localeフィールドは必須です。その他の照合フィールドはすべてオプションです。 フィールドの説明については、 「照合ドキュメント」 を参照してください。 照合が指定されていないが、コレクションにデフォルトの照合がある場合、操作はコレクションに指定された照合を使用します。 コレクションにも操作にも照合が指定されていない場合、MongoDB では以前のバージョンで使用されていた単純なバイナリ比較によって string が比較されます。
comment	混合	データベースプロファイラ、 currentOp出力、およびログから操作を追跡するのに役立つ任意のコメントを指定できるようにします。 このオプションは MongoDB 4.4 以降で使用可能であり、古いサーバー バージョンで指定すると実行時に例外が発生します。 バージョン 1.13 の新機能。
hint	string|array|object	使用するインデックス。 インデックス名を string またはインデックス キー パターンをドキュメントとして指定します。 指定すると、クエリ システムはヒント指定したインデックスを使用するプランのみを考慮します。 バージョン1.2での変更: ドキュメントが指定されている場合、それはそのまま コマンドに渡されます。 以前は、ライブラリはキー パターンをインデックス名に変換していました。
limit	integer	返される一致するドキュメントの最大数。
maxTimeMS	integer	カーソルに対する情報処理操作の累積時間制限（ミリ秒単位）。 MongoDB は、次の割り込みポイントが最も近い時点で操作を中止します。
ReadConcern	MongoDB\Driver\ReadConcern	操作に使用する読み取り保証。 デフォルトはコレクションの読み取り保証 (read concern) です。 トランザクションの一部である個々の操作に対して読み取り保証を指定することはできません。 代わりに 、トランザクションを開始する ときにreadConcern オプションを設定します。
readPreference	MongoDB\Driver\ReadPreference	操作に使用する読み取り設定。 コレクションの読み込み設定（read preference）がデフォルトで設定されます。
セッション	MongoDB\Driver\Session	操作に関連付けるクライアント セッション。 バージョン 1.3 で追加。
スキップ	integer	結果を返す前にスキップするマッチするドキュメントの数。

Return Values

フィルター条件に一致するドキュメントの数。

エラーと例外

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

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

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

MongoDB\Driver\Exception\RuntimeException 拡張レベルのその他のエラー（例:）。

動作

このメソッドは非推奨であり、トランザクション内で実行することはできません。 これは常にcountコマンドを使用して実装されています。 countコマンドの動作は、渡されるオプションによって異なり、正確なカウントが提供される場合と提供されない場合があります。 クエリフィルターが指定されていない場合、 countコマンドはコレクション メタデータを使用して推定値を提供します。 クエリフィルターが指定されている場合でも、孤立したドキュメントが存在する場合や チャンク移行 が進行中の場合に、 countコマンドはシャーディングされたクラスターで不正確な結果を返す可能性があります。 MongoDB\Collection::countDocuments()メソッドは、これらのシャーディングされたクラスターの問題を完全に回避します。

クエリ条件を評価する際、MongoDB は BSON types の独自の比較ルール に従って型と値を比較します。これは PHP の 比較と は異なります と 型の調整 ルール。特殊な BSON 型と一致する場合、クエリ条件はそれぞれの BSON クラス を使用する必要があります 拡張機能（例:MongoDB\BSON \ObjectId ObjectIdを使用 ）

その他の参照

• カウントコマンドの参照（MongoDB マニュアル）

• MongoDB\Collection::countDocuments()

• MongoDB\Collection::estimatedDocumentCount()