Table Store Java SDK 更新時序表配置 - Tablestore

前提條件

安裝Tablestore Java SDK並初始化時序模型用戶端。

功能說明

調用 updateTimeseriesTable 方法更新時序表配置。單次請求只能更新時序資料配置或時間軸中繼資料配置，不能同時更新兩類配置。

public UpdateTimeseriesTableResponse updateTimeseriesTable(UpdateTimeseriesTableRequest request)

以下樣本將 example_timeseries_table 中時序資料的生命週期更新為 3 年。

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

String tableName = "example_timeseries_table";
UpdateTimeseriesTableRequest request =
        new UpdateTimeseriesTableRequest(tableName);
request.setTimeseriesTableOptions(
        new TimeseriesTableOptions(86400 * 365 * 3));

timeseriesClient.updateTimeseriesTable(request);

參數說明

UpdateTimeseriesTableRequest 包含以下參數。

名稱	類型	說明
timeseriesTableName（必選）	`String`	要更新配置的時序表名稱。
timeseriesTableOptions（可選）	`TimeseriesTableOptions`	時序資料配置。`timeseriesTableOptions` 和 `timeseriesMetaOptions` 必須且只能配置其中一個。
timeseriesMetaOptions（可選）	`TimeseriesMetaOptions`	時間軸中繼資料配置。`timeseriesTableOptions` 和 `timeseriesMetaOptions` 必須且只能配置其中一個。

時序資料配置

timeseriesTableOptions 的類型為 TimeseriesTableOptions，包含以下參數。

名稱

類型

說明

timeToLive（必選）

int

時序資料的生命週期，單位為秒。取值為 -1 或不小於 86400 的整數；-1 表示資料永不到期。

資料超過生命週期後由系統自動清理。

時間軸中繼資料的生命週期不是 -1 時，該值不能大於時間軸中繼資料的生命週期；將該值設定為 -1 前，必須先將時間軸中繼資料的生命週期設定為 -1。

時間軸中繼資料配置

timeseriesMetaOptions 的類型為 TimeseriesMetaOptions。必須至少配置以下一個參數；未配置的參數保持當前值。

名稱

類型

說明

metaTimeToLive（可選）

int

時間軸中繼資料的生命週期，單位為秒。取值為 -1 或不小於 604800 的整數；-1 表示時間軸中繼資料永不到期。

該值不能小於時序資料的生命週期；時序資料的生命週期為 -1 時，該值也必須為 -1。

設定有限生命週期時，必須將 allowUpdateAttributes 設定為 false。

allowUpdateAttributes（可選）

boolean

是否允許更新時間軸中繼資料的屬性列。時間軸中繼資料的生命週期不是 -1 時，該值必須為 false。

情境樣本

更新時間軸中繼資料配置

以下樣本將時間軸中繼資料的生命週期更新為永不到期，並允許更新中繼資料屬性列。

String tableName = "example_timeseries_table";
TimeseriesMetaOptions metaOptions = new TimeseriesMetaOptions();
metaOptions.setMetaTimeToLive(-1);
metaOptions.setAllowUpdateAttributes(true);

UpdateTimeseriesTableRequest request =
        new UpdateTimeseriesTableRequest(tableName);
request.setTimeseriesMetaOptions(metaOptions);

timeseriesClient.updateTimeseriesTable(request);