influx v2 cli设置influxdb过期策略

---

背景

最近刚使用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设置过期策略）