赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 表格存储
  4. 开发参考
  5. API参考(数据管理)
  6. API概览
  7. 多元索引操作
  8. UpdateSearchIndex

UpdateSearchIndex

  • 多元索引操作
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

调用UpdateSearchIndex接口更新多元索引的配置,包括数据生命周期(TTL)和多元索引schema。

注意事项

  • 当修改多元索引生命周期时,请确保数据表为禁止更新状态(即allow_update为false)。具体操作,请参见UpdateTable。

  • 由于通过SDK调用API修改多元索引schema的操作较复杂,因此如需修改多元索引schema,请通过控制台进行操作。具体操作,请参见动态修改schema。

请求消息结构

message UpdateSearchIndexRequest {
    optional string table_name = 1;
    optional string index_name = 2;
    optional string switch_index_name = 3;
    repeated QueryFlowWeight query_flow_weight = 4;
    optional int32 time_to_live = 5;  // unit is seconds
}

名称

类型

是否必选

描述

table_name

string

是

数据表名称。

index_name

string

是

多元索引名称。

switch_index_name

string

否

修改后的多元索引名称。只有当使用动态修改schema功能修改多元索引结构时,才需要设置此参数。

query_flow_weight

QueryFlowWeight

否

查询权重配置。只有当使用动态修改schema功能修改多元索引结构时,才需要设置此参数。

time_to_live

int32

否

数据生命周期,即数据保存时间。单位为秒。

默认值为-1,表示数据永不过期。数据生命周期的取值最低为86400秒(一天),也可设置为-1(永不过期)。

当数据的保存时间超过设置的数据生命周期时,系统会自动清理超过数据生命周期的数据。

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

响应消息结构

message UpdateSearchIndexResponse {
}

您需要通过判断HTTP请求的status取值是否为200来确定是否执行成功。

  • 如果status取值为200,则表示执行成功。

  • 如果status取值为400或者500,则表示执行失败。

    如果请求执行失败时,则会返回Error信息。更多信息,请参见Error。

使用SDK

您可以使用如下语言的SDK更新多元索引的生命周期配置。

  • Java SDK:更新多元索引配置

  • Go SDK:更新多元索引配置

  • Python SDK:更新多元索引配置

  • Node.js SDK:更新多元索引配置

  • .NET SDK:更新多元索引配置

  • PHP SDK:更新多元索引配置

相关文章

CreateSearchIndex 2025-04-22 14:33

调用CreateSearchIndex接口创建一个多元索引。 说明 关于多元索引的更多信息,请参见多元索引介绍。

UpdateSearchIndex 2025-04-22 14:33

调用UpdateSearchIndex接口更新多元索引的配置,包括数据生命周期(TTL)和多元索引schema。 注意事项 当修改多元索引生命周期时,请确保数据表为禁止更新状态(即allow_update

ListSearchIndex 2025-04-22 14:33

调用ListSearchIndex接口列出多元索引列表。 请求消息结构 message ListSearchIndexRequest { optional string table_name = 1; }

DescribeSearchIndex 2025-04-22 14:33

调用DescribeSearchIndex接口查询多元索引描述信息,包括多元索引的字段信息和索引配置等。 请求消息结构 message DescribeSearchIndexRequest { optional st

DeleteSearchIndex 2025-04-22 14:33

调用DeleteSearchIndex接口删除一个多元索引。 注意事项 多元索引删除后不可恢复,请谨慎操作。 请求消息结构

Search 2025-04-22 14:33

调用Search接口通过多元索引查询数据。 请求消息结构 message SearchRequest { optional string table_name = 1; o

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