Todos os produtos
Search
Central de documentação

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

Última atualização: Jul 03, 2026

Atualize o tempo de vida (TTL) de um índice de pesquisa usando o Tablestore SDK for Node.js por meio da operação UpdateSearchIndex.

Pré-requisitos

Observações de uso

  • O TTL de um índice de pesquisa é independente do TTL da tabela de dados associada, mas não pode ser superior a ele. Caso precise reduzir o TTL tanto do índice quanto da tabela, altere primeiro o valor do índice de pesquisa e só depois modifique o da tabela de dados.

  • O Tablestore remove diariamente os dados expirados dos índices de pesquisa. Enquanto essa limpeza não ocorre, ainda é possível consultar esses registros. A exclusão definitiva acontece automaticamente no ciclo seguinte.

  • Após a alteração do TTL em tabelas de dados e índices de pesquisa, o Tablestore exclui os dados históricos expirados no próximo ciclo de limpeza.

Parâmetros

Parâmetro

Descrição

tableName (obrigatório)

Nome da tabela de dados.

indexName (obrigatório)

Nome do índice de pesquisa.

timeToLive (obrigatório)

TTL do índice de pesquisa, em segundos. Defina como -1 para dados que nunca expiram. Utilize um valor int32 positivo para estabelecer um período fixo de expiração. O valor máximo de int32 corresponde a aproximadamente 68 anos.

Exemplos

O exemplo abaixo define o TTL de um índice de pesquisa para sete dias (604.800 segundos):

let params = {
    tableName: '<TABLE_NAME>',
    indexName: '<SEARCH_INDEX_NAME>',
    timeToLive: 604800,  // 7 days in seconds (7 x 24 x 60 x 60)
}
client.updateSearchIndex(params, function (err, data) {
    if (err) {
        console.log('updateSearchIndex error:', err.toString());
    } else {
        console.log('updateSearchIndex success:', data);
    }
});

Para obter o valor de timeToLive referente a outro período, multiplique a quantidade de dias por 86400 (segundos por dia). Por exemplo, 30 dias equivalem a 2592000.

Perguntas frequentes

[[O que fazer quando a mensagem de erro [table ttl] must be bigger than or equal search index ttl é retornada ao modificar o TTL de uma tabela de dados?](t2633375.xdita#)](t2633375.xdita#)

Referências