當需要清理分析存儲中的歷史數據或者希望延長數據保存時間時,您可以使用UpdateTimeseriesAnalyticalStore接口更新時序分析存儲的數據生命周期TTL配置。更新分析存儲的TTL后,表格存儲會自動異步清理分析存儲中超過TTL的數據。
前提條件
已初始化TimeseriesClient。具體操作,請參見初始化TimeseriesClient。
注意事項
分析存儲的同步選項不支持更新。
分析存儲的生命周期最短為30天(即2592000秒)。
創建分析存儲時,如果設置的TTL不為-1,則表格存儲會自動異步刪除超過TTL的數據。您也可以通過UpdateTimeseriesAnalyticalStore接口修改分析存儲的TTL。
超過TTL的過期數據為無效數據,即使系統還未刪除數據,用戶已無法讀取對應數據。
當調小TTL時,數據表中可能會有數據過期,系統會異步刪除對應過期數據。
當調大TTL時,如果系統還未刪除在舊的TTL之外以前版本的數據,且對應版本數據在新設的TTL中,則對應版本的數據可以重新讀取。
參數
參數 | 說明 | |
timeseriesTableName | 時序表名。 | |
analyticalStore | analyticalStoreName | 分析存儲名。 |
timeToLive | 分析存儲數據存活時間,單位為秒。取值范圍為-1(數據永不過期)或者大于等于2592000秒(即30天)的int32正整數。 如果希望分析存儲中的數據永不過期,可以設置為-1。 |
示例
以下示例用于更新test_timeseries_table時序表下名為test_analytical_store分析存儲的數據生命周期為30天(即2592000秒)。
public void updateAnalyticalStore(TimeseriesClient client) {
//設置分析存儲名稱。
TimeseriesAnalyticalStore store = new TimeseriesAnalyticalStore("test_analytical_store");
//更新分析存儲的數據生命周期為2592000秒。
store.setTimeToLive(2592000);
//設置時序表名稱。
UpdateTimeseriesAnalyticalStoreRequest request = new UpdateTimeseriesAnalyticalStoreRequest("test_timeseries_table");
request.setAnalyticStore(store);
client.updateTimeseriesAnalyticalStore(request);
}
文檔內容是否對您有幫助?