Todos os produtos
Search
Central de documentação

Tablestore:UpdateSearchIndex

Última atualização: Jun 30, 2026

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

Notas de uso

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

  • Modifique o schema de um índice de pesquisa por SDK envolve operações complexas. Recomendamos alterar o schema diretamente no console do Tablestore. Para mais detalhes, consulte Modificar dinamicamente o schema de um índice de pesquisa.

Sintaxe da solicitaçã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

Nome da tabela de dados.

index_name

string

Sim

Nome do índice de pesquisa.

switch_index_name

string

Não

Novo nome do índice de pesquisa. Obrigatório apenas para modifique dinamicamente o schema do índice.

query_flow_weight

QueryFlowWeight

Não

Configurações de peso. Obrigatório apenas para modifique dinamicamente o schema do índice de pesquisa.

time_to_live

int32

Não

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

O valor padrão é -1, indicando que os dados nunca expiram. O TTL deve ser de pelo menos 86.400 segundos (um dia) ou -1.

Dados cujo tempo de retenção excede o TTL são considerados expirados. O Tablestore exclui automaticamente esses dados.

O TTL do índice de pesquisa é independente e não pode ser maior que o da tabela de dados correspondente. Para reduzir ambos, altere primeiro o TTL do índice de pesquisa e depois o da tabela de dados.

Sintaxe da resposta

message UpdateSearchIndexResponse {
}
  • HTTP 200: chamada bem-sucedida.

  • HTTP 400 ou 500: falha na chamada.

    A resposta contém uma mensagem de erro. Para mais informações, consulte Erro.

Usar SDKs do Tablestore

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