All Products
Search
Document Center

Tablestore:Update the configurations of a search index

Last Updated:Dec 11, 2024

After you create a search index, you can call the UpdateSearchIndex operation to update the configurations of the search index. This topic describes how to use Tablestore SDK for Node.js to update the time to live (TTL) of a search index.

Prerequisites

Usage notes

  • The TTL of a search index is independent of and must be no greater than that of the data table for which the search index is created. If you want to decrease the TTL of a search index and the data table for which the search index is created, you must change the TTL of the search index before you change the TTL of the data table.

  • Tablestore automatically deletes expired data from search indexes every day. You can still query expired data in search indexes before the expired data is deleted. Tablestore automatically deletes the expired data in the next cycle.

  • After you change the TTL of data tables and search indexes, Tablestore automatically deletes the historical expired data from the data tables and search indexes in the next cycle.

Parameters

Parameter

Description

tableName (required)

The name of the data table.

indexName (required)

The name of the search index.

timeToLive (required)

The TTL of the search index.

The TTL of a search index must be -1 or a positive int32 value in seconds. A value of -1 specifies that data in the search index never expires, and the maximum int32 value is equivalent to approximately 68 years.

Examples

The following sample code provides an example on how to change the TTL of a search index to seven days:

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

FAQ

What do I do if the [table ttl] must be bigger than or equal search index ttl error message is returned when I modify the TTL of a data table?

References