Todos los productos
Search
Centro de documentos

Tablestore:Actualización de la configuración de un índice de búsqueda

Última actualización: Sep 20, 2026

Actualice el tiempo de vida (TTL) de un índice de búsqueda con el SDK de Tablestore para Node.js mediante la llamada a la operación UpdateSearchIndex.

Requisitos previos

Notas de uso

Al configurar el TTL de un índice de búsqueda, tenga en cuenta lo siguiente:

  • El TTL de la tabla de datos y el del índice de búsqueda son independientes entre sí. El TTL del índice de búsqueda no puede superar al de la tabla de datos. Si necesita acortar ambos valores al mismo tiempo, actualice primero el TTL del índice de búsqueda y después el de la tabla de datos.

  • El índice de búsqueda elimina los datos caducados diariamente. Entre el momento en que los datos caducan y la ejecución de la siguiente tarea de limpieza, las consultas aún podrían devolverlos.

  • Después de acortar el TTL, el sistema elimina los datos históricos caducados durante las tareas de limpieza posteriores.

Parámetros

Parámetro

Descripción

tableName (obligatorio)

Nombre de la tabla de datos.

indexName (obligatorio)

Nombre del índice de búsqueda.

timeToLive (obligatorio)

TTL del índice de búsqueda, expresado en segundos. Establezca este valor en -1 para que los datos nunca caduquen. Asigne un valor int32 positivo para definir un periodo de caducidad fijo. El valor máximo de int32 equivale aproximadamente a 68 años.

Ejemplos

A continuación se muestra un ejemplo que establece el TTL de un índice de búsqueda en siete días (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 calcular el valor de timeToLive correspondiente a otra duración, multiplique la cantidad de días por 86400 (segundos por día). Por ejemplo, 30 días equivalen a 2592000.

Preguntas frecuentes

[[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?](t2633375.xdita#)](t2633375.xdita#)

Referencias