Todos os produtos
Search
Central de documentação

Tablestore:UpdateSearchIndex

Última atualização: Sep 29, 2026

Atualize as configurações de um índice de pesquisa, incluindo o tempo de vida (TTL) e as configurações de esquema.

Observações de uso

  • Para atualizar o TTL de um índice de pesquisa, defina o parâmetro allow_update como false na tabela de dados associada ao índice de pesquisa. Para mais informações, consulte UpdateTable.

  • Modifique o esquema de um índice de pesquisa chamando a operação de API específica por meio de um SDK é complexo. Modifique o esquema do índice de pesquisa no console do Tablestore. Para mais informações, consulte Dynamically modify the schema of a search index.

Sintaxe da requisição

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
}

Parâmetro

Tipo

Obrigatório

Descrição

table_name

string

Sim

O nome da tabela de dados.

index_name

string

Sim

O nome do índice de pesquisa.

switch_index_name

string

Não

O novo nome do índice de pesquisa. Esse parâmetro é obrigatório apenas para modificar dinamicamente o esquema do índice de pesquisa.

query_flow_weight

QueryFlowWeight

Não

As configurações de peso. Esse parâmetro é obrigatório apenas para modificar dinamicamente o esquema do índice de pesquisa.

time_to_live

int32

Não

O período de retenção dos dados no índice de pesquisa. Unidade: segundos.

O valor padrão é -1, o que indica que os dados nunca expiram. O TTL deve ser de, no mínimo, 86.400 segundos (um dia) ou -1.

Se o período de retenção dos dados exceder o TTL, eles expirarão. O Tablestore exclui automaticamente os dados expirados.

O TTL de um índice de pesquisa é independente e não deve ser maior que o da tabela de dados associada ao índice. Para diminuir o TTL de um índice de pesquisa e da tabela de dados associada, modifique o TTL do índice de pesquisa antes de modificar o TTL da tabela de dados.

Sintaxe da resposta

message UpdateSearchIndexResponse {
}

Uma chamada bem-sucedida retorna o código de status HTTP 200. Qualquer outro código de status indica falha.

  • HTTP 200: a chamada foi bem-sucedida.

  • HTTP 400 ou 500: a chamada falhou.

    A resposta inclui uma mensagem de erro. Para mais informações, consulte Error.

Usar SDKs do Tablestore

Use os seguintes SDKs do Tablestore para atualizar as configurações de TTL de um índice de pesquisa: