带驱动程序的 MongoDB
重要
mongosh 方法
本页面提供 mongosh 方法的相关信息。这不是数据库命令或特定语言驱动程序(例如 Node.js)的相关文档。
有关数据库命令,请参阅 collStats 命令。
如需了解 MongoDB API 驱动程序,请参阅特定语言的 MongoDB 驱动程序文档。
定义
注意
db.collection.stats() 默认在内部调用 $collStats 聚合阶段。
语法
方法的格式如下:
db.collection.stats({ scale: <num>, // Optional indexDetails: <boolean>, // Optional indexDetailsKey: <document>, // Optional indexDetailsName: <string>. // Optional})字段
字段 | 类型 | 说明 |
|---|---|---|
| 数字 | 可选。各种大小数据的比例因子。 如果指定了非整数比例因子,MongoDB 将使用该因子的整数部分。例如,如果指定比例因子为 从版本 4.2 开始,输出包括用于缩放大小值的 |
| 布尔 | |
| 文档 | 可选。如果 如果未找到匹配项, 使用 |
| 字符串 | 可选。如果 如果未找到匹配项, 使用 |
如要仅指定scale因素,MongoDB 支持旧格式:
db.collection.stats(<number>)兼容性
此方法可用于以下环境中托管的部署:
- MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务
注意
所有 MongoDB Atlas 集群都支持此命令。有关 Atlas 对所有命令的支持的信息,请参阅不支持的命令。
MongoDB Enterprise:基于订阅、自我管理的 MongoDB 版本
MongoDB Community:源代码可用、免费使用且可自行管理的 MongoDB 版本
行为
缩放的大小
除非指标名称另有指定(例如 "bytes currently in the cache"),否则与大小相关的值以字节为单位显示,并且可以被 scale 覆盖。
比例因子会将受影响的大小值四舍五入为整数。
引擎加密
根据存储引擎的不同,返回的数据可能会有所不同。有关字段的详细信息,请参阅输出详情。
意外关闭后的准确性
使用 Wired Tiger 存储引擎非正常关闭 mongod 后,db.collection.stats() 报告的计数和大小统计数据可能不准确。
偏差的大小取决于在最后一个检查点和非正常关闭之间执行的插入、更新或删除操作的次数。检查点通常每 60 秒出现一次。但是,如果 mongod 实例使用了非默认的 --syncdelay 设置,则检查点出现的次数可能会增多或减少。
在 mongod 的每个集合上运行 validate,以在非正常关闭之后恢复统计信息。
非正常关闭后:
副本集节点状态限制
要在副本集成员上运行,collStats 操作需要成员处于 PRIMARY 或 SECONDARY 状态。如果节点处于其他状态,如 STARTUP2,则操作错误。
索引筛选器行为
使用 indexDetailsKey 或 indexDetailsName 对 indexDetails 进行过滤只会返回一个匹配索引。如果未找到完全匹配项,indexDetails 将显示该集合所有索引的相关信息。
indexDetailsKey 字段采用以下格式的文档:
{ '<string>' : <value>, '<string>' : <value>, ... }其中,<string>> 为对其创建索引的字段,而 <value> 为此索引的方向或是某一特殊索引类型,例如 text 或 2dsphere。请参阅索引类型以查看索引类型的完整列表。
从 MongoDB 8.0开始,使用查询设置而不是添加索引筛选器。 从 MongoDB 8.0开始,索引筛选器已弃用。
查询设置的功能比索引筛选器更多。 此外,索引筛选器不是持久性的,您无法轻松地为所有集群节点创建索引筛选器。 要添加查询设置并探索示例,请参阅setQuerySettings 。
意外关闭和计数
对于使用 WiredTiger 存储引擎的 MongoDB 实例,在非正常关闭后,有关大小和计数的统计信息可能会最多减少 1000 份文档,如 collStats、dbStats、count 报告所示。要为集合恢复正确的统计信息,请对该集合运行 validate。
进行中的索引
db.collection.stats() 包括有关当前正在构建的索引的信息。有关详细信息,请参阅:
示例
本页上的示例使用来自 sample_mflix 数据集的数据。有关如何将此数据集加载到您的自管理 MongoDB 部署中的详细信息,请参阅 加载示例数据集。如果您对示例数据库进行了任何修改,您可能需要删除并重新创建数据库,才能运行此页面上的示例。
基本统计信息查询
以下操作将返回有关 sample_mflix 数据库中的 movies 集合的统计信息:
db.movies.stats(){ ok: 1, capped: false, ns: 'sample_mflix.movies', size: ..., count: 21349, avgObjSize: 1598, storageSize: ..., nindexes: 2, totalIndexSize: ..., totalSize: ..., indexSizes: { _id_: ..., cast_text_fullplot_text_genres_text_title_text: ... }, scaleFactor: 1}如果您未指定 scale 参数,则所有大小值均以 bytes 为单位。
使用比例表查询统计数据
以下操作通过指定 scale 为 1024,以 kilobytes 而非 bytes 返回大小值:
db.movies.stats( { scale : 1024 } ){ ok: 1, capped: false, ns: 'sample_mflix.movies', size: ..., count: 21349, avgObjSize: 1598, storageSize: ..., nindexes: 2, totalIndexSize: ..., totalSize: ..., indexSizes: { _id_: ..., cast_text_fullplot_text_genres_text_title_text: ... }, scaleFactor: 1024}附带索引详细信息的统计信息查找
以下操作返回一个 indexDetails 字段,其中包含与集合中每个索引相关的信息:
db.movies.stats( { indexDetails : true } ){ ok: 1, capped: false, ns: 'sample_mflix.movies', count: 21349, nindexes: 2, indexDetails: { _id_: ..., cast_text_fullplot_text_genres_text_title_text: ... }, indexSizes: { _id_: ..., cast_text_fullplot_text_genres_text_title_text: ... }, scaleFactor: 1}附带筛选后索引详细信息的统计信息查找
要使用过滤器 indexDetails 字段中的索引,请使用 indexDetailsKey 选项指定索引键,或使用 indexDetailsName 选项指定索引名称。若要发现索引键和名称,请使用 db.collection.getIndexes()。
给定以下索引:
{ "ns" : "sample_mflix.movies", "v" : 2, "key" : { "_fts" : "text", "_ftsx" : 1 }, "name" : "cast_text_fullplot_text_genres_text_title_text", "weights" : { "cast" : 1, "fullplot" : 1, "genres" : 1, "title" : 1 }, "default_language" : "english", "language_override" : "language", "textIndexVersion" : 3}以下操作使用 indexDetailsKey 选项将 indexDetails 文档过滤器为单个索引。
db.movies.stats( { 'indexDetails' : true, 'indexDetailsKey' : { '_fts' : 'text', '_ftsx' : 1 } })以下操作使用 indexDetailsName 选项将 indexDetails 文档过滤器为单个索引。
db.movies.stats( { 'indexDetails' : true, 'indexDetailsName' : 'cast_text_fullplot_text_genres_text_title_text' })这两个操作返回相同的输出:
{ ok: 1, capped: false, ns: 'sample_mflix.movies', count: 21349, nindexes: 2, indexDetails: { cast_text_fullplot_text_genres_text_title_text: ... }, indexSizes: { _id_: ..., cast_text_fullplot_text_genres_text_title_text: ... }, scaleFactor: 1}有关输出的解释,请参阅 输出详情。