Table Store Java SDK 更新多元索引生命週期 - Tablestore

前提條件

開始前，完成以下準備工作：

安裝 5.12.0 及以上版本的 Tablestore Java SDK 並初始化用戶端。
已建立待更新的資料表和多元索引，並禁止資料表通過 UpdateRow 更新資料。關於資料表更新設定，請參見更新表配置。

功能說明

調用 updateSearchIndex 方法更新指定多元索引的資料生命週期。

public UpdateSearchIndexResponse updateSearchIndex(UpdateSearchIndexRequest request)

如需增刪索引欄位、修改欄位類型、路由欄位或預排序配置，請參見動態修改 Schema。

重要

配置生命週期時，注意以下事項：

資料表和多元索引的生命週期相互獨立，索引生命週期不能超過資料表生命週期。如果需要同時縮短二者的生命週期，請先更新多元索引，再更新資料表。
多元索引按天清理到期資料。資料到期後、下次清理前，查詢仍可能返回這些資料。
縮短生命週期後，系統在後續清理任務中刪除已到期的存量資料。

以下樣本將 example_table 中 example_index 的生命週期更新為 7 天。

String tableName = "example_table";
String indexName = "example_index";
UpdateSearchIndexRequest request =
        new UpdateSearchIndexRequest(tableName, indexName);
request.setTimeToLiveInDays(7);

client.updateSearchIndex(request);

請求成功後，查詢多元索引資訊，確認 timeToLive 已變為 604800 秒。

參數說明

UpdateSearchIndexRequest 更新索引生命週期時使用以下參數：

名稱	類型	說明
tableName（必選）	`String`	資料表名稱。
indexName（必選）	`String`	多元索引名稱。
timeToLive（必選）	`Integer`	索引資料的生命週期，單位為秒。取值為 `-1` 或 int32 範圍內的正整數，`-1` 表示資料永不到期，最大值約為 68 年。通過 `setTimeToLive(int, TimeUnit)` 指定時間單位，或通過 `setTimeToLiveInDays(int)` 按天設定。