stats() (コレクションの統計)
最終更新：2026-10-09
stats() (コレクションの統計)
stats() はコレクションの統計を返します。例: `db.users.stats()` では、ドキュメント数、コレクションサイズ、ストレージサイズ、インデックス数とサイズ、シャーディング情報などを取得できます。容量評価と健全性評価の標準ツールです。サイズフィールドはバイト単位で、ドキュメント数などの一部のメトリクスはメタデータベースの推定値です。
| カテゴリ | インデックスと管理 |
|---|---|
| MongoDB バージョン | 1.0+ |
| 例の言語 | mongosh（シェル） |
📝 構文
db.<collection>.stats()戻り値：count、size、storageSize、indexSizes などを持つ統計オブジェクト。
▶ 例
以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：
// stats: users のサイズとドキュメント数を確認する
const s = db.users.stats()
print('Docs: ' + s.count + ', storage: ' + s.storageSize + ' bytes')出力：
Docs: 1000, storage: 65536 bytes📌 注意事項
- count などのフィールドはメタデータベースで、ずれることがある
- サイズフィールドはバイト単位
- インデックスサイズは indexSizes にあり、インデックス名がキー
🏷️ 関連タグ
💡 関連ケース
さらなる実践ケースを近日公開予定。
📚 関連チュートリアル
❓ よくある質問
Qstats() のサイズフィールドの単位は？
Aバイトです。storageSize を 1024*1024 で割ると MB になります。
Qstats() の count は正確ですか？
A通常は近いですが、メタデータベースで書き込みが多いと遅れることがあります。正確さには countDocuments() を使います。
Q各インデックスのサイズを見るには？
AindexSizes オブジェクトを読みます。キーがインデックス名、値がバイトサイズです。
