bucket 是什么
bucket 是 InfluxDB 2.x 的存储与保留单位：创建时用 -r 指定保留期（0 表示不自动过期），之后可以随时更新；管理命令都基于 org 作用域。保留期到期的数据由后台服务按桶清理，改动保留期不会立刻删除超期数据，需要等周期任务执行。查看与删除用 influx bucket list 与 influx bucket delete，脚本里要保证 -o 参数指向正确的组织。
基本信息
| 创建 | influx bucket create -n metrics -o my-org -r 30d |
|---|---|
| 更新 | influx bucket update -n metrics -o my-org -r 90d |
| 查看与删除 | influx bucket list -o my-org；influx bucket delete -n old -o my-org |
| 保留期单位 | s / m / h / d / w，0 表示永久保留 |
| 所属系统 | InfluxDB 2.x 命令行工具 |
典型使用场景
- 建桶规划：按数据用途分桶，分别设置保留期
- 延长窗口：业务需要更长查询周期时调大保留期
- 控制磁盘：缩短保留期控制占用，属于低风险操作
- 环境巡检：列出组织下全部桶及其保留期
- 清理测试数据：删除废弃桶释放空间
管理命令
管理命令
influx bucket create -n metrics -o my-org -r 30d # 建桶并设 30 天保留
influx bucket update -n metrics -o my-org -r 90d # 调整为 90 天
influx bucket list -o my-org --hide-headers | cut -f1,2,5 # 列出桶与保留期
# influx bucket delete -n old -o my-org # 删除废弃桶（连带数据，谨慎）参数读法
| 参数 | 含义 | 注意 |
|---|---|---|
| -n | 桶名称 | 部分子命令需要 ID 而非名称 |
| -o | 组织 | 写错会提示找不到桶 |
| -r | 保留期 | 单位 s/m/h/d/w，0 表示永久 |
| list | 列出桶 | 加 --hide-headers 便于脚本处理 |
| delete | 删除桶 | 连带其中数据一起删除 |
保留期到期后由后台服务按桶清理，改动保留期不会立即删除超期数据，需要等待周期任务执行，脚本里不要假设改完立刻生效。
把保留期设短是低风险操作，设长或改回永久前先估算磁盘容量，写满后会影响整个实例的写入。
CLI 的 -n 参数在部分子命令里指名称、部分场景需要 ID，命令报错时先核对帮助信息，不要凭印象反复重试。
写入与查询都必须显式指定桶，桶名在同一组织内唯一；跨组织存在同名桶，把组织与桶名一起做成配置项能减少手误。