dbStats（数据库统计）
最后更新：2026-10-09
dbStats（数据库统计）
dbStats返回当前数据库的统计信息：集合数、文档数、数据大小、索引大小、存储占用等，用于容量规划与监控。mongosh中用db.stats()或db.runCommand({ dbStats: 1 })。scale参数控制字节单位（1024为KB）。分片集群中返回的是聚合统计。
| 分类 | 监控诊断 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
db.stats()
db.runCommand({ dbStats: 1, scale: 1024 })⚙️ 参数
| scale | 字节单位换算因子，1024表示KB |
|---|
返回值：统计文档：db、collections、objects、dataSize、storageSize、indexSize、ok等
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// dbStats：查看数据库统计
use shop
db.runCommand({ dbStats: 1, scale: 1024 })运行结果：
{
db: 'shop',
collections: 5,
objects: 1200,
avgObjSize: 402,
dataSize: 482,
storageSize: 1024,
indexes: 7,
indexSize: 341,
ok: 1
}📌 注意事项
- scale参数控制单位（1024为KB）
- dataSize是逻辑大小，storageSize是磁盘占用
- 分片集群返回聚合统计
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
QdbStats和collStats有什么区别？
AdbStats是库级汇总，collStats针对单个集合。
QdataSize和storageSize怎么理解？
AdataSize是文档逻辑大小，storageSize是磁盘实际占用（含空闲空间与压缩）。
Q单位怎么换算？
A传scale: 1024输出KB，不传为字节。
