/ /

$count（集計ステージ）

定義

$count

ステージに入力されたドキュメントの数を含むドキュメントを次のステージに渡します。

注意

曖昧さ回避

このページでは、$count 集計パイプラインステージについて説明します。$count もこれらの他のコンテキストで使用できます。

$count (accumulator)、グループにあるドキュメントの数を返します。
$count (window function) は、$setWindowFields ステージで、特定のウィンドウ内のドキュメントの数を返すために使用されます。

互換性

次の環境でホストされる配置には $count を使用できます。

MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

$count の構文は次のとおりです。

{ $count: <string> }

<string> はカウントを値として持つ出力フィールドの名前です。<string> には空でない文字列であること、$ で始まらないこと、. 文字を含まないことという条件があります。

動作

戻り値の型は、カウントの最終値を保存できる最小の型で表されます:integer →long →double

The $count stage is equivalent to the following $group and $project sequence:

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

myCount は、カウントを保存する出力フィールドです。この出力フィールドには別の名前を指定できます。

入力データセットが空の場合、$count は結果を返しません。

Tip

db.collection.countDocuments() は $group 集計ステージを $sum 式でラップします。

例

このページの例では、sample_mflix データセットのデータを使用しています。自己管理型 MongoDB 配置にこのデータセットをロードする方法の詳細については、「サンプルデータセットのロード」を参照してください。サンプルデータベースに何らかの変更を加えた場合は、今ページの例を実行するには、データベースを削除して再作成する必要がある可能性があります。

次の集計操作には 2 つのステージがあります。

$match ステージでは、metacritic が 100 に等しいドキュメントをフィルタリングして、それらのドキュメントのみを次のステージに渡します。
$count ステージは、集計パイプラインに残っているドキュメントの数を返し、その値を perfect_score_count というフィールドに割り当てます。

db.movies.aggregate( [
   { $match: { metacritic: { $eq: 100 } } },
   { $count: "perfect_score_count" }
] )

[ { perfect_score_count: 8 } ]

次の Movie クラスは、sample_mflix.movies コレクション内のドキュメントをモデル化します。

[BsonIgnoreExtraElements]
public class Movie
{
    [BsonId]
    public ObjectId Id { get; set; }
    [BsonElement("title")]
    public string Title { get; set; } = null!;
    [BsonElement("year")]
    public int? Year { get; set; }
    [BsonElement("runtime")]
    public int? Runtime { get; set; }
    [BsonElement("rated")]
    public string? Rated { get; set; }
    [BsonElement("metacritic")]
    public int Metacritic { get; set; }
    [BsonElement("plot")]
    public string? Plot { get; set; }
    [BsonElement("type")]
    public string? Type { get; set; }
    [BsonElement("cast")]
    public string[]? Cast { get; set; }
    [BsonElement("directors")]
    public string[]? Directors { get; set; }
    [BsonElement("writers")]
    public string[]? Writers { get; set; }
    [BsonElement("imdb")]
    public ImdbData? Imdb { get; set; }
}

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Match(Builders<Movie>.Filter.Eq(m => m.Metacritic, 100))
    .Count();

このページのNode.js の例では、Atlasサンプルデータセットの sample_mflixデータベースを使用します。無料のMongoDB Atlas cluster を作成し、サンプルデータセットをロードする方法については、 MongoDB Node.jsドライバーのドキュメントの開始を参照してください。

MongoDB Node.jsドライバーを使用して $count ステージを集計パイプラインに追加するには、パイプラインオブジェクトで $count 演算子を使用します。

次の例では、sample_mflix.moviesコレクションからの入力ドキュメントの数をカウントし、カウントを含むドキュメントを返すパイプラインステージを作成します。次に、この例では集計パイプラインを実行します。

const pipeline = [{ $count: "movies" }];
const cursor = collection.aggregate(pipeline);
return cursor;

詳細

戻る

$collStats

$currentOp