原文地址：https://www.linuxdaxue.com/retention-policies-in-influxdb.html

一、InfluxDB 資料保留策略 說明

InfluxDB的資料保留策略（RP） 用來定義資料在InfluxDB中存放的時間，或者定義儲存某個期間的資料。

一個數據庫可以有多個保留策略，但每個策略必須是獨一無二的。

二、InfluxDB 資料保留策略 目的

InfluxDB本身不提供資料的刪除操作，因此用來控制資料量的方式就是定義資料保留策略。

因此定義資料保留策略的目的是讓InfluxDB能夠知道可以丟棄哪些資料，從而更高效的處理資料。

三、InfluxDB 資料保留策略 操作

1）查詢策略

可以通過如下語句檢視資料庫的現有策略：

> SHOW RETENTION POLICIES ON telegraf
name    duration    shardGroupDuration    replicaN    default
default    0        168h0m0s        1        true

可以看到，telegraf只有一個策略，各欄位的含義如下：

name--名稱，此示例名稱為 default

duration--持續時間，0代表無限制

shardGroupDuration--shardGroup的儲存時間，shardGroup是InfluxDB的一個基本儲存結構，應該大於這個時間的資料在查詢效率上應該有所降低。

replicaN--全稱是REPLICATION，副本個數

default--是否是預設策略

2）新建策略

> CREATE RETENTION POLICY "2_hours" ON "telegraf" DURATION 2h REPLICATION 1 DEFAULT
> SHOW RETENTION POLICIES ON telegraf
name    duration    shardGroupDuration    replicaN    default
default    0        168h0m0s        1        false
2_hours    2h0m0s        1h0m0s            1        true
 

通過上面的語句可以新增策略，本例在 telegraf 庫添加了一個2小時的策略，名字叫做 2_hours， duration為2小時，副本為1，設定為預設策略。

因為名為default的策略不再是預設策略，因此，在查詢使用default策略的表時要顯式的加上策略名 “default”。

> select * from "default".cpu limit 2
name: cpu
---------
time            cpu        host                host_id    usage_guest    usage_guest_nice    usage_idle   usage_iowait        usage_irq    usage_nice        usage_softirq    usage_steal    usage_system        usage_user
1467884670000000000    cpu-total    ResourcePool-0246-billing07        0        0            99.79994164175388    0            0        0.06251823446523729    0        0        0.12920435125646068    0.008335764603451727
1467884670000000000    cpu9        billing07                0        0            97.79338014069532    1.8054162487519367    0        0            0        0        0.10030090272883943    0.3009027081135398

3）修改策略

修改策略使用如下語句修改

> ALTER RETENTION POLICY "2_hours" ON "telegraf" DURATION 4h DEFAULT
> show retention POLICIES on telegraf
name    duration    shardGroupDuration    replicaN    default
default    0        168h0m0s        1        false
2_hours    4h0m0s        1h0m0s            1        true

可以看到，修改後的策略發生了變化。

4）刪除策略

InfluxDB中策略的刪除操作如下所示：

> drop retention POLICY "2_hours" ON "telegraf"
> show retention POLICIES on telegraf
name    duration    shardGroupDuration    replicaN    default
default    0        168h0m0s        1        false

可以看到，名為2_hours的策略已經被刪除了。

四、其他說明

策略這個關鍵詞“POLICY”在使用是應該大寫，小寫應該會出粗。

當一個表使用的策略不是預設策略時，在進行操作時一定要顯式的指定策略名稱，否則會出現錯誤。

五、練習示例

>  CREATE RETENTION POLICY "20_days" ON "statistics" DURATION 20d REPLICATION 1 DEFAULT
ERR: database not found: statistics
>  CREATE RETENTION POLICY "20_days" ON "rtvsweb" DURATION 20d REPLICATION 1 DEFAULT
> SHOW RETENTION POLICIES ON rtvsweb
name    duration shardGroupDuration replicaN default
----    -------- ------------------ -------- -------
autogen 0s       168h0m0s           1        false
20_days 480h0m0s 24h0m0s            1        true
>