$bucketAuto（自动分桶）

最后更新：2026-10-09

$bucketAuto（自动分桶）

$bucketAuto 自动把文档均分到指定数量的桶，尽量让每桶文档数接近，无需手动指定边界：只需给分组键和桶数，系统按数值分布计算边界。granularity 可让边界落在规范化的数字序列上。输出文档的 _id 为 { min, max } 边界对象。适合自动直方图与分布概览。

📝 语法

{ $bucketAuto: { groupBy: <表达式>, buckets: <正整数>, output: { <字段>: <累加器> }, granularity: <粒度> } }

⚙️ 参数

返回值：每个桶一条 { _id: { min, max }, count, ... } 文档

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// $bucketAuto：自动分成 4 桶并求均值
db.scores.aggregate([
  { $bucketAuto: {
    groupBy: '$score',
    buckets: 4,
    output: { avg: { $avg: '$score' } }
  } }
])

运行结果：

{ "_id": { "min": 0, "max": 45 }, "count": 10, "avg": 22.4 }
{ "_id": { "min": 45, "max": 82 }, "count": 10, "avg": 63.1 }

📌 注意事项

• buckets 只是目标数，实际桶数可能更少（文档少或值相同时）
• 输出 _id 为 { min, max } 边界对象，左闭右开
• granularity 让边界落在规范化数值序列上

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们