目录
- 背景
- 解法
- 设置config
- 设置buckets
- 找到需要修改的bucket ID
- 更新bucket保留策略
- 参考资料
背景
最近刚使用influxdb，需要对某个db设置一个过期策略。由于初次使用，对influx client命令行不熟悉，于是在网上找相关的教程，但是搜到的几乎全是v1版本的influx的使用方式，对于v2版本，除了官方文档外鲜有介绍。尤其针对我这里需要设置RETENTION POLICY（保留策略）的需求，更是不好找。经过仔细研究官方文档，终于找到对应的命令，现在此记录下。
解法
设置config
为了避免每个命令都传递host、API token等参数，需要将它们存在配置文件中。influx需要这些凭证的时候会自动从active的配置中检索这些凭证。
下面命令中CONFIG_NAME、ORG、API_TOKEN需要替换成具体的值
influx config create --config-name CONFIG_NAME \--host-url http://localhost:8086 \--org ORG \--token API_TOKEN \--active
配置好之后，每条命令后面就不需要手动加相关的鉴权凭证了。
设置buckets
官方文档介绍，在v2中，使用buckets而不是 InfluxDBv1.x中的retention policies概念来配置保留策略。
官方文档给的命令行参数解释如下：
-r --retention New duration bucket will retain data. For detail, see Retention periods. --shard-group-duration Custom shard group duration for the bucket (OSS only)
可以看到，
--retention参数是用来设置数据保留的持续时长，最小为1h（retention policy duration must be at least 1h0m0s）。如果设置为0，数据永久保存（官方默认RP），否则过期清理;
--shard-group-duration是用来设置数据存储在shardGroup的时间跨度，shardGroup是influxdb的一个逻辑存储结构，其下包含多个shard。
shardGroupDuration是根据retention policy的duration计算得来，不过也可以在创建retention policy指定。如下是retention policy’s duration和shardGroupDuration的计算关系：
| retention policy’s duration | shardGroupDuration |
|---|---|
| < 2 days | 1h |
| >= 2 days and <= 6 months | 1 day |
| > 6 months | 7 days |
找到需要修改的bucket ID
influx bucket list
更新bucket保留策略
下面命令中BUCKET_ID、DURATION需要替换成具体的值
influx bucket update --id BUCKET_ID --retention DURATION --shard-group-duration DURATION
例如，如果 bucket ID 是 1234567890abcdef，并且想设置 30 天的保留策略，shardGroupDuration设置为1天：
influx bucket update --id 1234567890abcdef --retention 30d --shard-group-duration 1d
返回
ID Name Retention Shard group duration Organization ID Schema Type
1234567890abcdef schema_1 720h0m0s 24h0m0s 7e7a1efexxxxxxx implicit
可以看到修改生效。
参考资料
详细的命令行参数，请参考官方文档
参考资料1（influx-cli v2 bucket官方文档）
参考资料2（influx-cli v2官方文档）
将一篇不错的，介绍v1版本的influx-cli如何设置RETENTION POLICY的文章也贴到这里
参考资料3（influx v1设置过期策略）
