Influxdb-Retention-Policy
retention policy这个东西相比较于传统的关系型数据库(比如mysql)而言,是一个比较新的东西,在将表之前,有必要来看一下保存策略有什么用,以及可以怎么用
I. 基本操作
1. 创建retention policy
retention policy依托于database存在,也就是说保存策略创建时,需要指定具体的数据库,语法如下
CREATE RETENTION POLICY <retention_policy_name> ON <database_name> DURATION <duration> REPLICATION <n> [SHARD DURATION <duration>] [DEFAULT]
创建语句中,有几个地方需要额外注意一下
- retention_policy_name: 策略名(自定义的)
- database_name: 一个必须存在的数据库名
- duration: 定义的数据保存时间,最低为1h,如果设置为0,表示数据持久不失效(默认的策略就是这样的)
- REPLICATION: 定义每个point保存的副本数,默认为1
- default: 表示将这个创建的保存策略设置为默认的
下面是一个实际的case,创建一个数据保存一年的策略
create retention policy "1Y" on test duration 366d replication 1
2. 策略查看
上面演示的case中,已经有如何查看一个数据库的保存策略了
show retention policies on <database name>
show retention policies on test
3. 修改保存策略
修改一个已经存在的保存策略,语法如下
ALTER RETENTION POLICY <retention_policy_name> ON <database_name> DURATION <duration> REPLICATION <n> SHARD DURATION <duration> DEFAULT
上面的定义和前面创建基本一致,下面给出一个case
alter retention policy "1Y" on test duration 365d replication 2 default
4. 删除保存策略
DROP RETENTION POLICY <retention_policy_name> ON <database_name>
当如下面的case,删除了默认的策略之后,会发现居然没有了默认的保存策略了,这个时候可能需要注意下,手动指定一个
drop retention policy "1Y" on test
II. 进阶说明
前面虽然介绍了保存策略的增删改查,但是这个东西究竟有什么用,又可以怎么用呢?
看一下前面查看保存策略的图
create retention policy "1Y" on test duration 366d replication 1
show retention policies on test
从前面的查看,可以看到保存策略主要有三个关键信息,数据保存时间, 数据分片时间, 副本数