全部产品
Search
文档中心

表格存储:创建 Lastpoint 索引

更新时间:Aug 04, 2026

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

String

时序表名称。

lastpointIndexName(必选)

String

Lastpoint 索引名称。

includeBaseData(必选)

boolean

是否同步索引创建前的存量数据。设置为 true 时同步存量数据;设置为 false 时不包含存量数据。两种取值都会同步索引创建后写入的数据。