更新时序表配置

更新时间:
复制 MD 格式

使用 Java SDK 更新时序数据和时间线元数据的生命周期,并配置是否允许更新时间线元数据的属性列。

前提条件

安装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

时序数据配置。timeseriesTableOptionstimeseriesMetaOptions 必须且只能配置其中一个。

timeseriesMetaOptions(可选)

TimeseriesMetaOptions

时间线元数据配置。timeseriesTableOptionstimeseriesMetaOptions 必须且只能配置其中一个。

时序数据配置

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);