全部產品
Search
文件中心

Tablestore:CreateSearchIndex

更新時間:Sep 30, 2026

調用CreateSearchIndex介面建立一個多元索引。

說明

關於多元索引的更多資訊,請參見多元索引。

注意事項

建立多元索引前,請確保資料表的最大版本數為1,資料生命週期滿足如下條件中的任意一個。

  • 資料表的資料生命週期為-1(資料永不到期)。

  • 資料表的資料生命週期不為-1時,資料表為禁止更新狀態(即是否允許更新為否)。

請求訊息結構

message CreateSearchIndexRequest {
    required string table_name = 1;
    required string index_name = 2;
    optional IndexSchema schema = 3;
    optional string source_index_name = 4;
    optional int32 time_to_live = 5; // unit is seconds
}

名稱

類型

是否必選

描述

table_name

string

是

資料表名稱。

index_name

string

是

多元索引名稱。

schema

IndexSchema

是

多元索引Schema。

source_index_name

string

否

源多元索引名稱。只有當使用動態修改schema時才需要設定此參數。

time_to_live

int32

否

多元索引生命週期,即資料的儲存時間。預設值為-1。單位為秒。

當資料的儲存時間超過設定的資料生命週期時,系統會自動清理超過資料生命週期的資料。

資料生命週期至少為86400秒(一天)或-1(資料永不到期)。

關於多元索引生命週期的更多資訊,請參見生命週期管理。

響應訊息結構

message CreateSearchIndexResponse {
}

通過HTTP請求的 status 判斷是否執行成功。

  • status 為 200,表示執行成功。

  • status 為 400 或 500,表示執行失敗。

    執行失敗時,響應中會返回 Error 資訊。更多資訊,請參見Error。

使用SDK

您可以使用如下語言的SDK建立多元索引。