Todos los productos
Search
Centro de documentos

Tablestore:Actualice la configuración del índice de búsqueda

Última actualización: Sep 03, 2026

Tablestore SDK for Java actualiza el tiempo de vida (TTL) de un índice de búsqueda.

Requisitos previos

Antes de empezar, asegúrese de contar con:

  • Tablestore SDK for Java 5.12.0 o posterior y un cliente inicializado.

  • Una tabla y un índice de búsqueda existentes, con las actualizaciones mediante UpdateRow deshabilitadas para la tabla. Para consultar la configuración de actualización de tablas, consulte Update table configurations.

Descripción

Llame a updateSearchIndex para actualizar el TTL de un índice de búsqueda.

public UpdateSearchIndexResponse updateSearchIndex(UpdateSearchIndexRequest request)

Para agregar o eliminar campos del índice, cambiar tipos de campo, campos de enrutamiento o configuraciones de preordenamiento, consulte Dynamically modify a search index schema.

Importante

Tenga en cuenta las siguientes reglas al configurar un TTL:

  • Los TTL de la tabla y del índice de búsqueda son independientes. El TTL del índice no puede superar el de la tabla. Para reducir ambos valores, actualice primero el índice de búsqueda y luego la tabla.

  • Tablestore elimina los datos caducados del índice mediante tareas de limpieza diarias. Las consultas pueden devolver datos caducados antes de que se ejecute la siguiente tarea de limpieza.

  • Al reducir el TTL, las tareas de limpieza posteriores eliminan los datos existentes que hayan caducado según la nueva configuración.

A continuación, el ejemplo actualiza el TTL de example_index para example_table a siete días.

String tableName = "example_table";
String indexName = "example_index";
UpdateSearchIndexRequest request =
        new UpdateSearchIndexRequest(tableName, indexName);
request.setTimeToLiveInDays(7);

client.updateSearchIndex(request);

Cuando la solicitud se complete correctamente, query the search index information y compruebe que timeToLive sea igual a 604800 segundos.

Parámetros

UpdateSearchIndexRequest usa los siguientes parámetros para actualizar el TTL de un índice:

Nombre

Tipo

Descripción

tableName (obligatorio)

String

Nombre de la tabla.

indexName (obligatorio)

String

Nombre del índice de búsqueda.

timeToLive (obligatorio)

Integer

TTL de los datos del índice en segundos. Los valores válidos son -1 y valores int32 positivos. Un valor de -1 indica que los datos no caducan. El valor máximo equivale aproximadamente a 68 años. Llame a setTimeToLive(int, TimeUnit) para especificar una unidad de tiempo, o a setTimeToLiveInDays(int) para especificar el TTL en días.