count（データベースコマンド）

コマンドフィールド

count には、次のフィールドがあります。

readConcern: { level: <value> }

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

クエリ述語のない不正確なカウント

クエリ述語なしでcountを呼び出すと、不正確なドキュメント数が返される可能性があります。 クエリ述語がない場合、 countコマンドはコレクションのメタデータに基づいて結果を返します。その結果、おおよそのカウントが返される場合があります。 特に、

• シャーディングされたクラスターでは、結果のカウントで孤立したドキュメントが正しく除外されません。

• シャットダウンを正常に行わなかった後、またはファイルのコピーによる初期同期の後は、カウントが正しくない場合があります。

コレクション メタデータに基づくカウントについては、「count オプション付きの CollStats パイプライン ステージ」も参照してください。

カウントとトランザクション

トランザクションでcountを使用すると、結果のカウントはコミットされていないマルチドキュメントトランザクションを除外しません。

詳細については、「トランザクションとカウント操作」を参照してください。

精度とシャーディングされたクラスター

シャーディングされたクラスターでは、クエリ述語なしで count コマンドを実行すると、 孤立したドキュメントが存在する場合や チャンク移行が進行中の場合に、不正確なカウントが発生する可能性があります。

このような状況を回避するには、シャーディングされたクラスターで db.collection.aggregate() メソッドを使用します。

$count ステージを使用してドキュメントをカウントできます。たとえば、次の操作はコレクション内のドキュメントをカウントします。

db.collection.aggregate( [
   { $count: "myCount" }
])

$count ステージは、次の$group + $project シーケンスと同等です。

db.collection.aggregate( [
   { $group: { _id: null, count: { $sum: 1 } } },
   { $project: { _id: 0 } }
] )

予期しないシャットダウン後の精度

mongodWired Tiger のストレージ エンジンを使用する の不正シャットダウン後、count によって報告されるカウント統計が不正確になる可能性があります。

ドリフトの量は、チェックポイントからクリーン シャットダウンまでの間に実行された挿入、アップデート、または削除操作の数によって異なります。チェックポイントは通常、60 秒ごとに発現します。ただし、デフォルト以外の --syncdelay 設定で実行されている mongod インスタンスでは、チェックポイントの頻度が増減する可能性があります。

不正なシャットダウン後に統計を復元するには、mongod の各コレクションに対して validate を実行します。

不正なシャットダウン後:

• validate は、collStats 出力 の カウント統計 を最新の値でアップデートします。

• collStats 出力で挿入または削除されたドキュメントの数などのその他の統計は推定値です。

クライアントの切断

操作が完了する前にcountを発行したクライアントが切断された場合、MongoDB はcountをkillOpを使用して終了対象としてマークします。

すべてのドキュメントをカウントする

次の操作は、orders コレクション内のすべてのドキュメントの数をカウントします。

db.runCommand( { count: 'orders' } )

結果では、カウントを表す n は、26 で、コマンド ステータス ok は 1 です。

{ "n" : 26, "ok" : 1 }

クエリに一致するドキュメントをカウントする

次の操作は、ord_dt フィールドの値が Date('01/01/2012') より大きい orders コレクション内のドキュメントのカウントを返します。

db.runCommand( { count:'orders',
                 query: { ord_dt: { $gt: new Date('01/01/2012') } }
               } )

結果では、カウントを表す n は、13 で、コマンド ステータス ok は 1 です。

{ "n" : 13, "ok" : 1 }

カウントするドキュメントをスキップする

次の操作は、ord_dt フィールドの値が Date('01/01/2012') より大きい orders コレクション内のドキュメントのカウントを返し、一致するドキュメントの最初の 10 件をスキップします。

db.runCommand( { count:'orders',
                 query: { ord_dt: { $gt: new Date('01/01/2012') } },
                 skip: 10 }  )

結果では、カウントを表す n は、3 で、コマンド ステータス ok は 1 です。

{ "n" : 3, "ok" : 1 }

使用するインデックスを指定する

次の操作では、インデックス { status: 1 } を使用して、ord_dt フィールドの値が Date('01/01/2012') より大きく、status フィールドが "D" に等しい orders コレクション内のドキュメントのカウントを返します。

db.runCommand(
   {
     count:'orders',
     query: {
              ord_dt: { $gt: new Date('01/01/2012') },
              status: "D"
            },
     hint: { status: 1 }
   }
)

結果では、カウントを表す n は、1 で、コマンド ステータス ok は 1 です。

{ "n" : 1, "ok" : 1 }

デフォルトの読み取り保証を上書き

デフォルトの読み取り保証 (read concern) レベル "local" を無効にするには、readConcern オプションを使用します。

レプリカセットに対する次の操作では、大多数のノードに書き込まれたことが確認されたデータの最新のコピーを読み取るために、"majority" の 読み取り保証を指定します。

db.runCommand(
   {
     count: "restaurants",
     query: { rating: { $gte: 4 } },
     readConcern: { level: "majority" }
   }
)

単一のスレッドでそれ自体の書き込みの読み取りを可能にするには、レプリカセットのプライマリに対して "majority" 読み取り保証と "majority" 書込み保証を使用します。