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查詢計量計費和多元索引計量計費。
一個時序表的Lastpoint索引與分析存儲的數量總和不得超過10個。
前提條件
已在支持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索引。