Todos os produtos
Search
Central de documentação

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

Última atualização: Sep 29, 2026

Após criar um índice de pesquisa, chame a operação UpdateSearchIndex para atualizar as configurações desse índice. Este tópico descreve como usar o Tablestore SDK for PHP para atualizar o time to live (TTL) de um índice de pesquisa.

Pré-requisitos

Notas de uso

  • O TTL de um índice de pesquisa é independente do TTL da tabela de dados à qual pertence e não pode ser maior do que ele. Para reduzir o TTL de um índice de pesquisa e da respectiva tabela de dados, altere primeiro o TTL do índice antes de alterar o TTL da tabela.

  • O Tablestore exclui automaticamente os dados expirados dos índices de pesquisa todos os dias. É possível ainda consultar dados expirados antes de serem excluídos; o Tablestore os remove no ciclo seguinte.

  • Após alterar o TTL de tabelas de dados e índices de pesquisa, o Tablestore exclui automaticamente os dados históricos expirados dessas tabelas e índices no próximo ciclo.

Parâmetros

Parâmetro

Descrição

table_name (obrigatório)

O nome da tabela de dados.

index_name (obrigatório)

O nome do índice de pesquisa.

time_to_live (obrigatório)

O TTL do índice de pesquisa.

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

Exemplos

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

$response = $otsClient->updateSearchIndex(array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'test_create_search_index',
    'time_to_live' => 60 * 60 * 24 * 7    // Unit: seconds. 
));

print json_encode($response, JSON_PRETTY_PRINT);

FAQ

[What do I do if the [table ttl] must be bigger than or equal search index ttl error message is returned when I modifique the TTL of a data table?](t2633375.xdita#)

Referências