全部產品
Search
文件中心

Tablestore:更新多元索引配置

更新時間:Sep 21, 2026

調用UpdateSearchIndex介面,通過Node.js SDK更新多元索引的資料生命週期(TTL)。

前提條件

  • 已初始化OTSClient執行個體。具體操作,請參見初始化Tablestore Client。

  • 資料表上已存在多元索引。

  • 資料表的allowUpdate參數已設定為false。具體操作,請參見更新表配置。

注意事項

  • 資料表和多元索引的生命週期相互獨立,索引生命週期不能超過資料表生命週期。如果需要同時縮短二者的生命週期,請先更新多元索引,再更新資料表。

  • 多元索引按天清理到期資料。資料到期後、下次清理前,查詢仍可能返回這些資料。

  • 縮短生命週期後,系統在後續清理任務中刪除已到期的存量資料。

參數

參數

說明

tableName(必選)

資料表名稱。

indexName(必選)

多元索引名稱。

timeToLive(必選)

多元索引的資料生命週期,單位為秒。設定為-1表示永久儲存;設定為正整數(int32)表示固定到期時間,最大值約為68年。

樣本

以下樣本將多元索引的資料生命週期設定為7天(604800秒)。

let params = {
    tableName: '<TABLE_NAME>',
    indexName: '<SEARCH_INDEX_NAME>',
    timeToLive: 604800,  // 7天,換算方式:7 × 24 × 60 × 60
}
client.updateSearchIndex(params, function (err, data) {
    if (err) {
        console.log('updateSearchIndex error:', err.toString());
    } else {
        console.log('updateSearchIndex success:', data);
    }
});

timeToLive的值為秒數。如需設定其他時間長度,將天數乘以86400即可,例如30天對應2592000秒。

常見問題

修改資料表生命週期時報錯[table ttl] must be bigger than or equal search index ttl

相關文檔