Actualice configuraciones de índices de búsqueda - Tablestore - Centro de documentación de Alibaba Cloud

Use Tablestore SDK for Python para actualizar el TTL de un índice de búsqueda.

Requisitos previos

Instale Tablestore SDK for Python e inicialice un cliente.
La tabla no admite operaciones UpdateRow. Es decir, allow_update está establecido en False. Para obtener más información, consulte Update table configurations.

Descripción

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

def update_search_index(
    self,
    table_name,
    index_name,
    index_meta,
)

Importante

Considere los puntos a continuación al configurar un TTL:

El método update_search_index de Tablestore SDK for Python solo actualiza el TTL. No modifica campos del índice, configuraciones del índice ni ajustes de preordenamiento.
Los valores de TTL de una tabla y de un índice de búsqueda son independientes; sin embargo, el TTL del índice de búsqueda no puede superar el de la tabla. Para aumentar el TTL del índice de búsqueda por encima del TTL actual de la tabla, primero incremente el TTL de la tabla. Para reducir el TTL de la tabla por debajo del TTL actual del índice de búsqueda, primero disminuya el TTL del índice de búsqueda.
Tablestore elimina los datos vencidos del índice de búsqueda una vez al día. Estos datos podrían seguir siendo consultables hasta el siguiente ciclo de eliminación. Después de reducir el TTL, Tablestore elimina los datos históricos vencidos en un ciclo posterior.

El ejemplo a continuación actualiza el TTL de example_index para example_table a siete días y consulta el valor actualizado.

index_meta = SearchIndexMeta(
    fields=None,
    time_to_live=7 * 24 * 60 * 60,
)
client.update_search_index(
    "example_table",
    "example_index",
    index_meta,
)

updated_meta, _ = client.describe_search_index(
    "example_table",
    "example_index",
)
print(updated_meta.time_to_live)

Parámetros

El método update_search_index incluye los parámetros a continuación.

Nombre	Tipo	Descripción
table_name (obligatorio)	`str`	Nombre de la tabla.
index_name (obligatorio)	`str`	Nombre del índice de búsqueda.
index_meta (obligatorio)	`SearchIndexMeta`	Configuraciones del índice de búsqueda por actualizar.

Configuraciones del índice de búsqueda

index_meta es un objeto SearchIndexMeta que contiene los parámetros a continuación para actualizar el TTL.

Nombre	Tipo	Descripción
fields (obligatorio)	`List[FieldSchema]`	Establezca este parámetro en `None`. La solicitud de actualización no modifica los campos del índice.
time_to_live (opcional)	`int`	TTL de los datos del índice en segundos. Valor predeterminado: `-1`. Establezca el valor en `-1` o en un valor int32 positivo. Un valor de `-1` indica que los datos no vencen. El valor máximo de int32 equivale aproximadamente a 68 años.

Ejemplos

Deshabilitar el TTL

Establezca time_to_live en -1 para que los datos del índice de búsqueda no venzan.

index_meta = SearchIndexMeta(fields=None, time_to_live=-1)
client.update_search_index(
    "example_table",
    "example_index",
    index_meta,
)