Actualización de configuraciones de tabla - Tablestore - Centro de documentación de Alibaba Cloud

Utilice Tablestore SDK for Python para actualizar las configuraciones de TTL, versión, modo de actualización y throughput reservado de una tabla.

Requisitos previos

Instale Tablestore SDK for Python e inicialice un cliente.

Descripción de la función

Llame al método update_table para actualizar las configuraciones de la tabla. Debe especificar como mínimo uno de los siguientes parámetros: table_options o reserved_throughput.

def update_table(
    self,
    table_name,
    table_options=None,
    reserved_throughput=None,
)

A continuación se muestra un ejemplo que cambia el TTL de example_table a siete días y deshabilita las actualizaciones mediante el método update_row.

table_options = TableOptions(
    time_to_live=604800,
    max_version=1,
    max_time_deviation=86400,
    allow_update=False,
)

client.update_table(
    "example_table",
    table_options=table_options,
)

Parámetros

El método update_table incluye los siguientes parámetros.

Nombre	Tipo	Descripción
table_name (obligatorio)	`str`	Nombre de la tabla.
table_options (opcional)	`TableOptions`	Configuraciones de la tabla que se van a actualizar. Debe especificar como mínimo este parámetro o `reserved_throughput`.
reserved_throughput (opcional)	`ReservedThroughput`	Throughput reservado que se va a actualizar. Debe especificar como mínimo este parámetro o `table_options`.

Configuraciones de tabla

El parámetro table_options es de tipo TableOptions e incluye los siguientes parámetros.

Nombre	Tipo	Descripción
time_to_live (opcional)	`int`	TTL de los datos en segundos. Un valor de `-1` indica que los datos nunca caducan. Si especifica otro valor, el mínimo es `86400`, que equivale a un día. Los datos caducados se eliminan automáticamente. Para usar un índice de búsqueda o un índice secundario, establezca este parámetro en `-1` o configure `allow_update` como `False`.
max_version (opcional)	`int`	Número máximo de versiones que se conservarán para cada columna de atributo. Para usar un índice de búsqueda o un índice secundario, establezca este parámetro en `1`.
max_time_deviation (opcional)	`int`	Desviación máxima de versión en segundos. La diferencia entre la marca de tiempo de los datos que se van a escribir y la hora actual del sistema debe estar dentro de la desviación máxima de versión. El rango de versiones válido es `[max(data write time - maximum version deviation, data write time - TTL), data write time + maximum version deviation)`.
allow_update (opcional)	`bool`	Indica si los datos se pueden actualizar mediante llamadas a `update_row`. Si establece este parámetro en `False`, no será posible actualizar los datos mediante `update_row`.

Throughput reservado

El parámetro reserved_throughput es de tipo ReservedThroughput e incluye el siguiente parámetro.

Nombre	Tipo	Descripción
capacity_unit (obligatorio)	`CapacityUnit`	reserved throughput en CU. Solo las instancias de alto rendimiento en modo CU admiten valores distintos de cero.

Respuesta

UpdateTableResponse contiene la siguiente información de negocio.

Campo	Tipo	Descripción
table_options	`TableOptions`	Configuraciones de tabla actualizadas.
reserved_throughput_details	`ReservedThroughputDetails`	Throughput reservado actual, junto con las horas del último aumento y la última disminución.

Ejemplos

Actualización del throughput reservado

En el siguiente ejemplo se establece el throughput reservado de example_table en 0 CU.

reserved_throughput = ReservedThroughput(
    CapacityUnit(read=0, write=0)
)

client.update_table(
    "example_table",
    reserved_throughput=reserved_throughput,
)