对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

db. 集合.stats()(mongosh方法)

带驱动程序的 MongoDB

本页面文档 mongosh 方法。要查看 MongoDB 驱动程序中的等效方法,请参阅您的编程语言的相应页面:

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是数据库命令或特定语言驱动程序(例如 Node.js)的相关文档。

有关数据库命令,请参阅 collStats 命令。

如需了解 MongoDB API 驱动程序,请参阅特定语言的 MongoDB 驱动程序文档。

db.collection.stats(<option>)

返回有关集合的统计信息。

返回:

一份包含指定集合的统计信息的文档。请参阅 collStats,了解返回统计数据的明细。

注意

db.collection.stats() 默认在内部调用 $collStats 聚合阶段。

方法的格式如下:

db.collection.stats({ scale: <num>, // Optional indexDetails: <boolean>, // Optional indexDetailsKey: <document>, // Optional indexDetailsName: <string>. // Optional})
字段
类型
说明

scale

数字

可选。各种大小数据的比例因子。scale 默认为 1,以字节为单位返回大小数据。要显示千字节而不是字节,请指定 1024 的 scale 值。

如果指定了非整数比例因子,MongoDB 将使用该因子的整数部分。例如,如果指定比例因子为 1023.999,MongoDB 将使用 1023 作为比例因子。

从版本 4.2 开始,输出包括用于缩放大小值的 scaleFactor 。

indexDetails

布尔

可选。 如果true , db.collection.stats()除了集合统计信息外还返回index details 。

仅适用于 WiredTiger 存储引擎。

默认值为 false。

indexDetailsKey

文档

可选。如果 indexDetails 为 true,可以使用 indexDetailsKey 通过指定索引键规范来筛选索引详情。仅返回与 indexDetailsKey 精确匹配的索引。

如果未找到匹配项,indexDetails 将显示所有索引的统计数据。

使用 getIndexes() 发现索引键。不能将 indexDetailsKey 与 indexDetailsName 一起使用。

indexDetailsName

字符串

可选。如果indexDetails为true,您可以通过指定索引name使用indexDetailsName来筛选索引详细信息。仅返回与indexDetailsName完全匹配的索引名称。

如果未找到匹配项,indexDetails 将显示所有索引的统计数据。

使用 getIndexes() 查找索引名称。不能将 indexDetailsName 与 indexDetailsField 一起使用。

如要仅指定scale因素,MongoDB 支持旧格式:

db.collection.stats(<number>)

此方法可用于以下环境中托管的部署:

  • MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务

注意

所有 MongoDB Atlas 集群都支持此命令。有关 Atlas 对所有命令的支持的信息,请参阅不支持的命令。

除非指标名称另有指定(例如 "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}

有关输出的解释,请参阅 输出详情。

给本页内容打分