赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 表格存储
  4. 开发参考
  5. SDK参考
  6. Java SDK
  7. 多元索引
  8. 索引管理
  9. 更新多元索引配置

更新多元索引配置

  • 索引管理
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

创建多元索引后,您可以使用UpdateSearchIndex接口更新多元索引配置。本文介绍如何通过Java SDK更新多元索引的数据生命周期。

前提条件

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

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

  • 确保数据表为禁止更新状态(即allowUpdate为false)。具体操作,请参见更新表配置。

注意事项

  • 多元索引的TTL和数据表的TTL是独立的,多元索引的TTL值必须小于或等于数据表的TTL值。当需要同时调小多元索引TTL和数据表TTL时,请先调整多元索引TTL,再调整数据表TTL。

  • 多元索引每天会自动清理已过期的数据,过期数据的清理粒度为“天”,因此您仍然可以查询到某一时刻已过期但尚未及时清理的数据,多元索引会在下一次清理过期数据时自动清理这些过期数据。

  • 数据表和多元索引的TTL更新后,系统会在下一次清理过期数据时自动清理数据表和多元索引中的过期存量数据。

参数

参数

说明

tableName(必选)

数据表名称。

indexName(必选)

多元索引名称。

timeToLive(必选)

多元索引生命周期。

多元索引的TTL取值范围为-1或者int32的正整数(单位为秒),其中-1表示永久存储,int32最大值换算为年大约为68年。

示例

以下示例用于更新多元索引的数据生命周期为7天。

// 请使用5.12.0及以上版本的Java SDK。
public static void updateIndexWithTTL(SyncClient client) {
    int days = 7;
    UpdateSearchIndexRequest updateSearchIndexRequest = new UpdateSearchIndexRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>");
    // 更新多元索引TTL。
    updateSearchIndexRequest.setTimeToLiveInDays(days);
    client.updateSearchIndex(updateSearchIndexRequest);
}

常见问题

修改数据表生命周期时报错[table ttl] must be bigger than or equal search index ttl

相关文档

  • 如果您想了解更多关于多元索引生命周期的信息,请参见多元索引生命周期管理。

  • 如果要查询某个多元索引的详细信息,例如多元索引的字段信息、索引结构等,您可以参考操作查询多元索引描述信息。

  • 如需在多元索引中新增、更新或者删除索引列,以及修改多元索引的路由键和预排序方式,您可以使用动态修改schema功能实现。具体操作,请参见动态修改schema。

相关文章

创建多元索引 2025-04-22 14:28

使用 CreateSearchIndex 接口在数据表上创建一个多元索引。一个数据表支持创建多个多元索引。创建多元索引时,您需要将要查询的字段添加到多元索引中,您还可以配置多元索引路由键、预排序等高级选项。

列出多元索引列表 2025-04-22 14:28

创建多元索引后,使用ListSearchIndex接口可以获取某个数据表关联的所有多元索引的列表信息。 前提条件

更新多元索引配置 2025-04-22 14:28

创建多元索引后,您可以使用UpdateSearchIndex接口更新多元索引配置。本文介绍如何通过Java SDK更新多元索引的数据生命周期。 前提条件 已初始化OTSClient。具体操作,请参见初始化

查询多元索引描述信息 2025-04-22 14:28

创建多元索引后,使用DescribeSearchIndex接口可以查询多元索引的描述信息,包括多元索引的字段信息和索引配置等。

删除多元索引 2025-04-22 14:28

本文介绍在Java SDK中如何删除多元索引。 注意事项 多元索引删除后不可恢复,请谨慎操作。 前提条件 初始化Tablestore Client<

生命周期管理 2025-04-22 14:28

数据生命周期(Time To Live,简称TTL)是多元索引的一个属性,即数据的保存时间。多元索引会自动清理超过保存时间的数据,减少用户的数据存储空间,降低存储成本。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号