Lastpoint索引可用于快速检索各时间线的最新时间点数据,您可以使用CreateTimeseriesLastpointIndex接口为时序表创建Lastpoint索引。创建Lastpoint索引时,您需要配置时序表名称和Lastpoint索引名称,以及根据需要配置是否在Lastpoint索引中包含时序表的存量数据。
您也可以在创建索引表时配置Lastpoint索引。更多信息,请参见创建时序表。
注意事项
表格存储Java SDK从5.17.1版本开始支持Lastpoint索引功能。使用该功能时,请确保获取了正确的Java SDK版本。关于Java SDK历史迭代版本的更多信息,请参见Java SDK历史迭代版本。
创建Lastpoint索引后,当写入数据到时序表时,表格存储会自动以异步方式将时序表中时间线的最新时间点数据同步到Lastpoint索引中,正常情况下同步延迟达到毫秒级别。
数据同步到Lastpoint索引表后,Lastpoint索引表中会包括表格存储为时间线生成的分区键(即
_#h
字段)、时间线标识以及时间线的最新时间点数据。构建Lastpoint索引过程中不会产生费用,Lastpoint索引的数据存储和索引中数据的读取会产生费用。更多信息,请参见时序模型计量计费。
如果使用了SQL查询或多元索引功能查询Lastpoint索引中的数据,则还会产生SQL查询和多元索引相关费用,产生的费用按照相应功能的使用规则计费。更多信息,请参见SQL查询计量计费和多元索引计量计费。
一个时序表最多只能创建10个Lastpoint索引。
前提条件
已在支持Lastpoint索引的地域下创建时序模型实例。具体操作,请参见创建时序模型实例。
已初始化TimeseriesClient。具体操作,请参见初始化TimeseriesClient。
参数
参数 | 是否必选 | 说明 |
timeseriesTableName | 是 | 时序表名称。 |
lastpointIndexName | 是 | Lastpoint索引名称。 |
includeBaseData | 否 | 是否包含存量数据。类型为Boolean。取值范围如下:
|
示例
以下示例用于在时序表timeseries_table下创建一个名称为last_point_index的Lastpoint索引,索引中包含存量数据。
public void createTimeseriesLastpointIndex(TimeseriesClient client) {
CreateTimeseriesLastpointIndexRequest request =
new CreateTimeseriesLastpointIndexRequest("timeseries_table", "last_point_index", true);
client.createTimeseriesLastpointIndex(request);
}
相关文档
创建Lastpoint索引后,您可以通过以下方式读取Lastpoint索引中的数据。
直接使用数据表的数据读取接口读取数据。更多信息,请参见读取数据。
为Lastpoint索引创建多元索引后,使用多元索引查询功能读取数据。
为Lastpoint索引创建SQL映射关系后,使用SELECT语句读取数据。
如果不再需要使用Lastpoint索引,您可以删除Lastpoint索引。更多信息,请参见删除Lastpoint索引。