使用 Java SDK 为时序表创建 Lastpoint 索引,以便读取每条时间线的最新时间点数据。
前提条件
安装Tablestore Java SDK并初始化时序模型客户端。Lastpoint 索引需要使用 5.17.1 及以上版本,建议使用最新版本。
已在支持 Lastpoint 索引的地域创建时序模型实例。支持地域及功能详情参见Lastpoint 索引。
功能说明
调用 createTimeseriesLastpointIndex 方法为时序表创建 Lastpoint 索引。索引包含系统生成的分区键 _#h、时间线标识以及每条时间线的最新时间点数据。
public CreateTimeseriesLastpointIndexResponse createTimeseriesLastpointIndex(CreateTimeseriesLastpointIndexRequest request) throws TableStoreException, ClientException
创建 Lastpoint 索引是异步操作。将 includeBaseData 设置为 true 时,系统先同步时序表中的存量数据;存量数据同步完成后,索引进入增量同步状态,采用本地索引方式同步新写入的数据,无同步延迟。设置为 false 时,索引不包含创建前的存量数据,但会同步创建后写入的数据。
一个时序表的 Lastpoint 索引与分析存储总数不能超过 10 个。构建 Lastpoint 索引不收费,索引数据存储和读取会产生费用;使用 SQL 或多元索引查询时,还会产生相应功能的费用。计费详情参见时序模型计量计费、SQL 查询计量计费和多元索引计量计费。
以下示例为 example_timeseries_table 创建 example_lastpoint_index,并同步存量数据。
TimeseriesClient timeseriesClient = client.asTimeseriesClient();
CreateTimeseriesLastpointIndexRequest request =
new CreateTimeseriesLastpointIndexRequest(
"example_timeseries_table",
"example_lastpoint_index",
true);
timeseriesClient.createTimeseriesLastpointIndex(request);
也可以在创建时序表时同时创建 Lastpoint 索引。
参数说明
CreateTimeseriesLastpointIndexRequest 包含以下参数。
|
名称 |
类型 |
说明 |
|
timeseriesTableName(必选) |
|
时序表名称。 |
|
lastpointIndexName(必选) |
|
Lastpoint 索引名称。 |
|
includeBaseData(必选) |
|
是否同步索引创建前的存量数据。设置为 |