全部產品
Search
文件中心

Tablestore:建立分析儲存

更新時間:Aug 04, 2026

使用 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(必選)

String

時序表名稱。

analyticalStore(必選)

TimeseriesAnalyticalStore

分析儲存配置。

分析儲存配置

analyticalStore 的類型為 TimeseriesAnalyticalStore,包含以下參數。

名稱

類型

說明

analyticalStoreName(必選)

String

分析儲存名稱。

timeToLive(可選)

int

分析儲存的資料生命週期,單位為秒,預設值為 -1。取值為 -1 或不小於 2592000int32 整數;-1 表示資料永不到期。系統根據資料列的時間戳記而不是資料寫入時間判斷資料是否到期,並自動清理到期資料。

syncOption(可選)

AnalyticalStoreSyncType

資料同步方式,預設值為 SYNC_TYPE_FULL。取值為 SYNC_TYPE_FULLSYNC_TYPE_INCR