MongoDB\Collection::count()

バージョン1.4 以降では非推奨。

定義

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) です。トランザクションの一部である個々の操作に対して読み取り保証 (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 type を照合する場合、BSONクラスは拡張機能（例:）。（ ObjectId を一致させるためにMongoDB$ BSON$ObjectId を使用）

その他の参照

カウントコマンドの参照（MongoDB マニュアル）
MongoDB\Collection::countDocuments()
MongoDB\Collection::estimatedDocumentCount()