使用 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(必选) |
|
要更新配置的时序表名称。 |
|
timeseriesTableOptions(可选) |
|
时序数据配置。 |
|
timeseriesMetaOptions(可选) |
|
时间线元数据配置。 |
时序数据配置
timeseriesTableOptions 的类型为 TimeseriesTableOptions,包含以下参数。
|
名称 |
类型 |
说明 |
|
timeToLive(必选) |
|
时序数据的生命周期,单位为秒。取值为 数据超过生命周期后由系统自动清理。 时间线元数据的生命周期不是 |
时间线元数据配置
timeseriesMetaOptions 的类型为 TimeseriesMetaOptions。必须至少配置以下一个参数;未配置的参数保持当前值。
|
名称 |
类型 |
说明 |
|
metaTimeToLive(可选) |
|
时间线元数据的生命周期,单位为秒。取值为 该值不能小于时序数据的生命周期;时序数据的生命周期为 设置有限生命周期时,必须将 |
|
allowUpdateAttributes(可选) |
|
是否允许更新时间线元数据的属性列。时间线元数据的生命周期不是 |
场景示例
更新时间线元数据配置
以下示例将时间线元数据的生命周期更新为永不过期,并允许更新元数据属性列。
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);