/ /

计算文档

Overview

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

样本数据

本指南中的示例使用名为 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`	对结果进行排序时使用的语言排序规则类型。有关详细信息，请参阅本页的排序规则部分。默认值： `null`
`Hint`	用于扫描要计数的文档的索引。默认值： `null`
`Limit`	要计数的最大文档数。默认值： `0`
`MaxTime`	查询可以在服务器上运行的最长时间。默认值： `null`
`Skip`	计数前要跳过的文档数。默认值： `0`

提示

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

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

排序规则

要为操作配置排序规则，请创建 Collation 类的实例。

下表描述了 Collation 构造函数接受的参数。它还列出了相应的类属性，您可以使用这些属性读取每个设置的值。

Parameter	说明	类属性
`locale`	指定 Unicode 国际组件 (ICU)区域设置设置。有关支持的区域设置列表，请参阅MongoDB Server手册中的排序规则区域设置和默认参数。如果要使用简单的二进制比较，请使用 `Collation.Simple`静态属性返回`Collation` 对象，并将`locale` 设立为`"simple"` 。数据类型：`string`	`Locale`
`caseLevel`	（可选）指定是否包括大小写比较。当此参数为 `true`时，驱动程序的行为取决于`strength` 参数的值： `strengthCollationStrength.Primary` - 如果`strength` 为`CollationStrength.Secondary` ，驾驶员会比较基本字符和大小写。 — 如果为，则驾驶员会比较基本字符、变音符号、其他从节点(secondary node from replica set)差异和大小写。 — 如果为任何其他值，则忽略此参数。当此参数为`strength` `false`时，驾驶员不包括强度级别`Primary` 或`Secondary` 的大小写比较。数据类型：`boolean` 默认值：`false`	`CaseLevel`
`caseFirst`	（可选）指定三级比较期间大小写差异的排序顺序。数据类型：CollationCaseFirst 默认值：`CollationCaseFirst.Off`	`CaseFirst`
`strength`	（可选）指定要执行的比较级别，如 ICU 文档中所定义。数据类型：CollationStrength 默认值：`CollationStrength.Tertiary`	`Strength`
`numericOrdering`	（可选）指定驾驶员是否将数字字符串作为数字进行比较。如果此参数为 `true`，则驾驶员将数字字符串作为数字进行比较。示例，在比较字符串10 210210 `false`"10 " 和 "2 " 时，驾驶员会将这些值视为和，并发现更大。如果此参数为或已排除，则驾驶员会将数字字符串作为字符串进行比较。示例，在比较字符串1 "2 " 和10 "2 " 时，驾驶员一次比较一个字符。由于“”小于“”，因此驾驶员会发现“”小于“”。有关更多信息，请参阅MongoDB Server手册中的排序规则限制。数据类型： `boolean` 默认值：`false`	`NumericOrdering`
`alternate`	（可选）指定驾驶员是否将空格和标点符号视为基本字符以进行比较。数据类型：CollationAlternate 默认值：`CollationAlternate.NonIgnorable` （空格和标点符号被视为基本字符）	`Alternate`
`maxVariable`	（可选）指定当 `alternate`参数为`CollationAlternate.Shifted` 时驾驶员认为哪些字符可忽略。数据类型：CollationMaxVariable 默认值：`CollationMaxVariable.Punctuation` （驾驶员忽略标点符号和空格）	`MaxVariable`
`normalization`	（可选）指定驾驶员是否根据需要对文本进行规范化。大多数文本不需要规范化。有关规范化的更多信息，请参阅 ICU 文档。数据类型： `boolean` 默认值：`false`	`Normalization`
`backwards`	（可选）指定包含变音符号的字符串是否从后往前排序。数据类型： `boolean` 默认值：`false`	`Backwards`

有关排序规则的更多信息，请参阅MongoDB Server手册中的排序规则页面。

预计数量

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

注意

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

修改行为

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

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

属性	说明
`MaxTime`	查询可以在服务器上运行的最长时间。默认值： `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 文档