Lastpoint索引可用於快速檢索各時間軸的最新時間點資料,您可以使用CreateTimeseriesLastpointIndex介面為時序表建立Lastpoint索引。建立Lastpoint索引時,您需要配置時序表名稱和Lastpoint索引名稱,以及根據需要配置是否在Lastpoint索引中包含時序表的存量資料。
您也可以在建立時序表時配置Lastpoint索引。更多資訊,請參見建立時序表。
注意事項
Table StoreJava SDK從5.17.1版本開始支援Lastpoint索引功能。使用該功能時,請確保擷取了正確的Java SDK版本。關於Java SDK歷史迭代版本的更多資訊,請參見Java SDK歷史迭代版本。
建立Lastpoint索引後,當寫入資料到時序表時,Table Store會自動以非同步方式將時序表中時間軸的最新時間點資料同步到Lastpoint索引中,正常情況下同步延遲達到毫秒層級。
資料同步到Lastpoint索引表後,Lastpoint索引表中會包括Table Store為時間軸產生的分區鍵(即
_#h
欄位)、時間軸標識以及時間軸的最新時間點資料。構建Lastpoint索引過程中不會產生費用,Lastpoint索引的資料存放區和索引中資料的讀取會產生費用。更多資訊,請參見時序模型計量計費。
如果使用了SQL查詢或多元索引功能查詢Lastpoint索引中的資料,則還會產生SQL查詢和多元索引相關費用,產生的費用按照相應功能的使用規則計費。更多資訊,請參見SQL查詢計量計費和多元索引計量計費。
一個時序表的Lastpoint索引與分析儲存的數量總和不得超過10個。
前提條件
已在支援Lastpoint索引的地區下建立時序模型執行個體。具體操作,請參見建立時序模型執行個體。
已初始化TimeseriesClient。具體操作,請參見初始化Tablestore Client。
參數
參數 | 是否必選 | 說明 |
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索引。