计算文档

在此页面上

Overview

准确计数
预计数量
聚合(Aggregation)
更多信息

Overview

本指南中，您可以了解如何获取集合中文档数量 accurate 和估计计数。

样本数据

本指南中的示例使用名为 students 的集合中的以下文档：

{ "_id": 1, "name": "Jonathon Howard ", "finalGrade": 87.5 }
{ "_id": 2, "name": "Keisha Freeman", "finalGrade": 12.3 }
{ "_id": 3, "name": "Wei Zhang", "finalGrade": 99.0 }
{ "_id": 4, "name": "Juan Gonzalez", "finalGrade": 85.5 }
{ "_id": 5, "name": "Erik Trout", "finalGrade": 72.3 }
{ "_id": 6, "name": "Demarcus Smith", "finalGrade": 88.8 }

以下 Student 类对此集合中的文档进行建模：

public class Student {
    public int Id { get; set; }
    public string Name { get; set; }
    public double FinalGrade { get; set; }
}

注意

students 集合中的文档使用驼峰命名约定。本指南中的示例使用 ConventionPack 将集合中的字段反序列化为 Pascal 语句，然后映射到 Student 类中的属性。

如需了解有关自定义序列化的更多信息，请参阅自定义序列化。

准确计数

要统计与您的查询筛选器匹配的文档数量，请使用 CountDocuments() 方法。如果传递空查询筛选器，则该方法将返回集合中的文档总数。

例子

以下示例计算其中的 finalGrade 值小于 80 的文档数：

var filter = Builders<Student>.Filter.Lt(s => s.FinalGrade, 80.0);
var count = _myColl.CountDocuments(filter);
Console.WriteLine("Number of documents with a final grade less than 80: " + count);

Number of documents with a final grade less than 80: 2

修改行为

您可以通过将 CountOptions 类型作为参数传入来修改 CountDocuments() 的行为。如果不指定任何选项，驱动程序将使用默认值。

您可以在 CountOptions 对象中设置以下属性：

属性	说明
`Collation`	The type of language collation to use when sorting results. Default: `null`
`Hint`	The index to use to scan for documents to count. Default: `null`
`Limit`	The maximum number of documents to count. Default: `0`
`MaxTime`	The maximum amount of time that the query can run on the server. Default: `null`
`Skip`	The number of documents to skip before counting. Default: `0`

提示

当你使用 CountDocuments() 返回集合中的文档总数时，MongoDB 会执行集合扫描。你可以使用提示来利用 _id 字段的内置索引，从而避免集合扫描并改进此方法的性能。仅当使用空查询参数调用 CountDocuments() 时才使用此技术。

var filter = Builders<Student>.Filter.Empty;
CountOptions opts = new CountOptions(){Hint = "_id_"};
var count = collection.CountDocuments(filter, opts);

预计数量

要估计集合中的文档总数，请使用 EstimatedDocumentCount() 方法。

注意

EstimatedDocumentCount() 方法比 CountDocuments() 方法更高效，因为它会使用集合的元数据而不是扫描整个集合。

修改行为

您可以通过将 EstimatedDocumentCountOptions 类型作为参数传入来修改 EstimatedDocumentCount() 的行为。如果不指定任何选项，驱动程序将使用默认值。

您可以在 EstimatedDocumentCountOptions 对象中设置以下属性：

属性	说明
`MaxTime`	The maximum amount of time that the query can run on the server. Default: `null`

例子

以下示例估计了 students 集合中的文档数量：

var count = _myColl.EstimatedDocumentCount();
Console.WriteLine("Estimated number of documents in the students collection: " + count);

Estimated number of documents in the students collection: 6

聚合(Aggregation)

您可以使用 Count() 构建其方法来计算聚合管道中的文档数量。

例子

以下示例执行以下动作：

指定匹配阶段，以查找 FinalGrade 值大于 80 的文档
统计符合条件的文档数量

var filter = Builders<Student>
  .Filter.Gt(s => s.FinalGrade, 80);
var result = _myColl.Aggregate().Match(filter).Count();
Console.WriteLine("Number of documents with a final grade more than 80: " + result.First().Count);

Number of documents with a final grade more than 80: 4

Overview

样本数据

注意

准确计数

例子

修改行为

提示

预计数量

注意

修改行为

例子

聚合(Aggregation)

例子

更多信息

API 文档