使用 Java SDK 為已有時序表建立分析儲存,用於低成本、長期儲存和分析時序資料。
前提條件
安裝Tablestore Java SDK並初始化時序模型用戶端。分析儲存功能需要使用 5.15.0 及以上版本,建議使用最新版本。
已在支援分析儲存的地區建立時序模型執行個體。支援地區及功能詳情參見分析儲存。
功能說明
調用 createTimeseriesAnalyticalStore 方法為已有時序表建立分析儲存。分析儲存會自動同步時序表中的資料,其資料生命週期與時序表的資料生命週期相互獨立,對分析儲存執行查詢不會影響時序表的讀寫效能。
public CreateTimeseriesAnalyticalStoreResponse createTimeseriesAnalyticalStore(CreateTimeseriesAnalyticalStoreRequest request) throws TableStoreException, ClientException建立分析儲存時,可以選擇以下資料同步方式:
SYNC_TYPE_FULL:同步時序表中的存量資料和建立後寫入的增量資料,預設使用該方式。SYNC_TYPE_INCR:僅同步分析儲存建立後寫入的增量資料。
同步方式建立後不能修改,請根據是否需要分析存量資料謹慎選擇。
一個時序表只能建立 1 個分析儲存。一個時序表的 Lastpoint 索引與分析儲存總數不能超過 10 個。
以下樣本為 example_timeseries_table 建立 example_analytical_store。分析儲存中的資料永不到期,並採用全量同步方式。
TimeseriesClient timeseriesClient = client.asTimeseriesClient();
TimeseriesAnalyticalStore analyticalStore =
new TimeseriesAnalyticalStore("example_analytical_store");
analyticalStore.setTimeToLive(-1);
analyticalStore.setSyncOption(AnalyticalStoreSyncType.SYNC_TYPE_FULL);
CreateTimeseriesAnalyticalStoreRequest request =
new CreateTimeseriesAnalyticalStoreRequest(
"example_timeseries_table", analyticalStore);
timeseriesClient.createTimeseriesAnalyticalStore(request);建立後,資料同步在後台執行。可以調用 describeTimeseriesAnalyticalStore 方法查看同步狀態,具體操作參見查詢分析儲存資訊。
參數說明
CreateTimeseriesAnalyticalStoreRequest 包含以下參數。
名稱 | 類型 | 說明 |
timeseriesTableName(必選) |
| 時序表名稱。 |
analyticalStore(必選) |
| 分析儲存配置。 |
分析儲存配置
analyticalStore 的類型為 TimeseriesAnalyticalStore,包含以下參數。
名稱 | 類型 | 說明 |
analyticalStoreName(必選) |
| 分析儲存名稱。 |
timeToLive(可選) |
| 分析儲存的資料生命週期,單位為秒,預設值為 |
syncOption(可選) |
| 資料同步方式,預設值為 |