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
WiredTiger
collStats.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引擎直接报告的数据以及其他用于内部诊断的数据。