collStats¶该collStats命令返回给定集合的各种存储统计信息。
要运行collStats，请使用方法。db.runCommand( { <command> } )
该collStats命令具有以下语法：
该命令包含以下字段：
| 领域 | 类型 | 描述 |
|---|---|---|
collStats |
串 | 目标集合的名称。 如果该集合不存在，则 |
scale |
整型 | 可选的。各种尺寸数据的比例因子（那些在字段名称中指定度量单位的尺寸除外）。该值默认为1以字节为单位返回大小数据。要显示千字节而不是字节，请指定 如果您指定非整数比例因子，则MongoDB将使用指定因子的整数部分。例如，如果将比例因子指定为 比例因子将受影响的大小值四舍五入为整数。 从4.2版开始，输出包括 |
注意
从4.2版开始，MongoDB删除MMAPv1存储引擎。结合此更改，MongoDB删除了MMAPv1特定collStats选项verbose。
除非度量标准名称（例如）另外指定，否则与大小相关的值以字节显示，并且可以被覆盖。"bytes
currently in the cache"scale
比例因子将受影响的大小值四舍五入为整数。
mongod使用Wired Tiger存储引擎不正常关闭后，所报告的大小统计信息
collStats可能不准确。
漂移量取决于在最后一个检查点与异常关闭之间执行的插入，更新或删除操作的数量。检查点通常每60秒出现一次。但是，mongod使用非默认--syncdelay设置运行的实例可能具有或多或少的频繁检查点。
以下操作collStats在restaurants集合上运行命令
，并指定1024字节的大小：
以下文档提供了collStats输出的表示形式
。根据您的集合和存储引擎的配置，输出字段可能会有所不同。
collStats.ns¶当前集合的名称空间，其格式为
[database].[collection]。
collStats.size¶集合中所有记录在内存中的总未压缩大小。，size不包括与该totalIndexSize字段报告的集合关联的任何索引的大小。
该scale参数影响此值。数据压缩不会影响此值。
collStats.count¶此集合中对象或文档的数量。
collStats.avgObjSize¶集合中对象的平均大小。该scale
参数不会影响此值。
collStats.storageSize¶分配给此集合以进行文档存储的存储总量
。该scale参数影响此值。
如果收集数据被压缩（为），则存储大小反映了压缩后的大小，并且可能小于的值。default for
WiredTigercollStats.size
storageSize不包括索引大小。有关totalIndexSize索引大小的信息，请参阅
。
collStats.indexDetails¶一个文档，用于报告WiredTiger 存储引擎中集合中每个索引的数据。其他存储引擎将返回空文档。
本文档中的字段是索引的名称，而值本身是包含存储引擎提供的索引统计信息的文档。这些统计信息供内部诊断使用。
从MongoDB 4.2开始，indexDetails包括有关当前正在构建的索引的详细信息。
collStats.indexBuilds¶包含当前在集合上构建的索引名称的数组。索引构建完成后，索引不会出现在中indexBuilds。
4.2版中的新功能。
collStats.totalIndexSize¶所有索引的总大小。该scale参数影响此值。
如果索引使用前缀压缩（即），则在计算总数时，返回的大小将反映任何此类索引的压缩大小。default
for WiredTiger
从MongoDB 4.2开始，totalIndexSize在其总大小中包括当前正在构建的那些索引的大小。
collStats.indexSizes¶该字段指定集合上每个现有索引的键和大小。该scale参数影响此值。
如果索引使用前缀压缩（即），则返回的大小将反映压缩后的大小。default
for WiredTiger
从MongoDB 4.2开始，indexSizes包括当前正在构建的索引的大小。
collStats.scaleFactor¶scale命令使用的值。
如果您指定了非整数比例因子，则MongoDB将使用指定因子的整数部分。例如，如果将比例因子指定为1023.999，则MongoDB将使用1023该比例因子。
4.2版中的新功能。
collStats.wiredTiger¶wiredTiger 仅在使用WiredTiger存储引擎时出现。
本文档包含WiredTiger引擎直接报告的数据以及其他用于内部诊断的数据。