Todos os produtos
Search
Central de documentação

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

Última atualização: Oct 09, 2026

Após a criação de um índice de pesquisa, chame a operação UpdateSearchIndex e atualize as configurações do índice. Este tópico descreve como usar o Tablestore SDK for .NET para atualizar o tempo de vida (TTL) de um índice de pesquisa.

Pré-requisitos

Observações de uso

  • O TTL de um índice de pesquisa é independente e não pode ser maior que o TTL da tabela de dados para a qual o índice foi criado. Se você quiser reduzir o TTL do índice de pesquisa e da tabela de dados associada, altere o TTL do índice de pesquisa antes de alterar o TTL da tabela de dados.

  • O Tablestore exclui automaticamente os dados expirados dos índices de pesquisa todos os dias. Você ainda pode consultar dados expirados nos índices de pesquisa antes que a exclusão ocorra. O Tablestore exclui os dados expirados automaticamente no próximo ciclo.

  • Após a alteração do TTL das tabelas de dados e dos índices de pesquisa, o Tablestore exclui automaticamente o histórico de dados expirados dessas tabelas e índices no próximo ciclo.

Parâmetros

Parâmetro

Descrição

TableName (obrigatório)

O nome da tabela de dados.

IndexName (obrigatório)

O nome do índice de pesquisa.

TimeToLive (obrigatório)

O TTL do índice de pesquisa.

O TTL de um índice de pesquisa deve ser -1 ou um valor int32 positivo em segundos. O valor -1 indica que os dados no índice de pesquisa nunca expiram, e o valor máximo do int32 equivale a aproximadamente 68 anos.

Exemplos

O código de exemplo a seguir mostra como alterar o TTL de um índice de pesquisa para sete dias:

public static void updatesearchindexttl(OTSClient otsClient)
{
    var TableName = "<TABLE_NAME>";
    var IndexName = "<SEARCH_INDEX_NAME>";
    try
    {
        UpdateSearchIndexRequest request = new UpdateSearchIndexRequest(TableName, IndexName);
        request.SetTimeToLive(3600 * 24 * 7);
        otsClient.UpdateSearchIndex(request);

    }
    catch (Exception ex)
    {
        // If the operation fails, an exception is returned. Handle the exception. 
        Console.WriteLine("Update search index ttl failed, exception:{0}", ex.Message);
    }          
}

Perguntas frequentes

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

Referências