表格存储：更新多元索引配置

前提条件

• 已初始化OTSClient实例。具体操作，请参见初始化Tablestore Client。

• 数据表上已存在多元索引。

• 数据表的allowUpdate参数已设置为false。具体操作，请参见更新表配置。

注意事项

• 数据表和多元索引的生命周期相互独立，索引生命周期不能超过数据表生命周期。如果需要同时缩短二者的生命周期，请先更新多元索引，再更新数据表。

• 多元索引按天清理过期数据。数据过期后、下次清理前，查询仍可能返回这些数据。

• 缩短生命周期后，系统在后续清理任务中删除已过期的存量数据。

参数

示例

以下示例将多元索引的数据生命周期设置为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

相关文档

• 了解多元索引数据生命周期的管理详情，请参见多元索引生命周期管理。

• 查询多元索引的字段信息、索引结构等详细信息，请参见查询多元索引描述信息。

• 新增、更新或删除索引列，或修改多元索引的路由字段和预排序方式，请参见动态修改schema。