$bucket（分桶）
最后更新：2026-10-09
$bucket（分桶）
$bucket 按边界把文档分到多个桶，每个桶输出一条 { _id: 下边界, count: N } 文档，可用 output 定义桶内累加结果。边界由升序的 boundaries 数组定义，文档按分组键值落入对应区间，不在任何桶内的进入 default 桶。适合直方图与区间统计。
| 分类 | 分组与窗口 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $bucket: { groupBy: <表达式>, boundaries: [ <下界>, ... ], default: <值>, output: { <字段>: <累加器> } } }⚙️ 参数
| groupBy | 决定文档落入哪个桶的表达式。 |
|---|---|
| boundaries | 升序的桶边界数组，至少两个值。 |
| default | 不在任何桶内的文档进入的桶名，省略则丢弃。 |
| output | 桶内累加器，如 { $avg } 或 { $sum }。 |
返回值：每个桶一条 { _id, count, ... } 文档
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $bucket：按分数区间分桶并求均值
db.scores.aggregate([
{ $bucket: {
groupBy: '$score',
boundaries: [0, 60, 80, 100],
default: 'other',
output: { avg: { $avg: '$score' } }
} }
])运行结果：
{ "_id": 0, "count": 12, "avg": 35.5 }
{ "_id": 60, "count": 20, "avg": 71.2 }📌 注意事项
- boundaries 必须升序且至少两个值
- 区间为左闭右开：值落入 [边界[i], 边界[i+1])
- 不落桶的文档进入 default 桶，省略 default 时被丢弃
🏷️ 相关标签
💡 相关案例
📚 相关教程
❓ 常见问题
Q$bucket 和 $bucketAuto 有什么区别？
A$bucket 手动指定边界；$bucketAuto 按文档数量自动均分桶。
Q区间是左闭右开吗？
A是，值落入 [边界[i], 边界[i+1])；最后一个边界是上界、不包含。
Qdefault 桶能省略吗？
A能，省略时不在桶内的文档直接丢弃。
