Todos os produtos
Search
Central de documentação

Tablestore:Atualizar configurações de índice de pesquisa

Última atualização: Aug 20, 2026

O Tablestore SDK for Java atualiza o tempo de vida (TTL) de um índice de pesquisa.

Pré-requisitos

Antes de começar, verifique se você tem:

  • Tablestore SDK for Java versão 5.12.0 ou posterior e um cliente inicializado.

  • Uma tabela e um índice de pesquisa existentes, com atualizações via UpdateRow desabilitadas para a tabela. Para obter detalhes sobre as configurações de atualização da tabela, consulte Update table configurations.

Descrição

Chame updateSearchIndex para atualizar o TTL de um índice de pesquisa.

public UpdateSearchIndexResponse updateSearchIndex(UpdateSearchIndexRequest request)

Para adicionar ou remover campos de índice, alterar tipos de campo, campos de roteamento ou configurações de pré-ordenação, consulte Dynamically modify a search index schema.

Importante

Observe as seguintes regras ao configurar um TTL:

  • Os TTLs da tabela e do índice de pesquisa são independentes. O TTL do índice não pode exceder o TTL da tabela. Para reduzir ambos, atualize o índice de pesquisa antes da tabela.

  • O Tablestore remove dados expirados do índice em tarefas diárias de limpeza. Consultas podem retornar dados expirados antes da próxima execução.

  • Após a redução do TTL, as tarefas de limpeza subsequentes removem os dados existentes que expiraram conforme a nova configuração.

O exemplo a seguir atualiza o TTL do example_index da example_table para sete dias.

String tableName = "example_table";
String indexName = "example_index";
UpdateSearchIndexRequest request =
        new UpdateSearchIndexRequest(tableName, indexName);
request.setTimeToLiveInDays(7);

client.updateSearchIndex(request);

Após o sucesso da solicitação, query the search index information e verifique se timeToLive é igual a 604800 segundos.

Parâmetros

UpdateSearchIndexRequest usa os seguintes parâmetros para atualizar o TTL de um índice:

Nome

Tipo

Descrição

tableName (obrigatório)

String

Nome da tabela.

indexName (obrigatório)

String

Nome do índice de pesquisa.

timeToLive (obrigatório)

Integer

TTL dos dados do índice em segundos. Os valores válidos são -1 e inteiros positivos de 32 bits. O valor -1 indica que os dados não expiram. O valor máximo equivale a aproximadamente 68 anos. Chame setTimeToLive(int, TimeUnit) para especificar uma unidade de tempo ou setTimeToLiveInDays(int) para definir o TTL em dias.