Actualización de configuraciones de tablas de series temporales - Tablestore

Utilice Tablestore SDK for Java para actualizar el tiempo de vida (TTL) de los datos y metadatos de series temporales, y especifique si se permite la actualización de las columnas de atributos de los metadatos.

Requisitos previos

Instale Tablestore SDK for Java e inicialice un cliente de series temporales.

Descripción

Llame a updateTimeseriesTable para actualizar las configuraciones de la tabla de series temporales. Cada solicitud puede actualizar las configuraciones de datos de series temporales o las configuraciones de metadatos, pero no ambas simultáneamente.

public UpdateTimeseriesTableResponse updateTimeseriesTable(UpdateTimeseriesTableRequest request)

A continuación se muestra un ejemplo que actualiza el TTL de datos de series temporales de example_timeseries_table a tres años.

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

String tableName = "example_timeseries_table";
UpdateTimeseriesTableRequest request =
        new UpdateTimeseriesTableRequest(tableName);
request.setTimeseriesTableOptions(
        new TimeseriesTableOptions(86400 * 365 * 3));

timeseriesClient.updateTimeseriesTable(request);

Parámetros

UpdateTimeseriesTableRequest contiene los siguientes parámetros.

Nombre	Tipo	Descripción
timeseriesTableName (obligatorio)	`String`	Nombre de la tabla de series temporales cuyas configuraciones desea actualizar.
timeseriesTableOptions (opcional)	`TimeseriesTableOptions`	Configuraciones de datos de series temporales. Debe especificar `timeseriesTableOptions` o `timeseriesMetaOptions`, pero no ambos.
timeseriesMetaOptions (opcional)	`TimeseriesMetaOptions`	Configuraciones de metadatos de series temporales. Debe especificar `timeseriesTableOptions` o `timeseriesMetaOptions`, pero no ambos.

Configuraciones de datos de series temporales

timeseriesTableOptions es de tipo TimeseriesTableOptions y contiene el siguiente parámetro.

Nombre

Tipo

Descripción

timeToLive (obligatorio)

int

TTL de los datos de series temporales en segundos. Establezca el valor en -1 o en un número entero de como mínimo 86,400. Un valor de -1 indica que los datos no caducan.

Tablestore elimina automáticamente los datos caducados.

Si el TTL de metadatos no es -1, este valor no puede superar el TTL de metadatos. Antes de establecer este valor en -1, configure el TTL de metadatos en -1.

Configuraciones de metadatos de series temporales

timeseriesMetaOptions es de tipo TimeseriesMetaOptions. Especifique como mínimo uno de los siguientes parámetros. Los parámetros omitidos conservan su valor actual.

Nombre

Tipo

Descripción

metaTimeToLive (opcional)

int

TTL de los metadatos de series temporales en segundos. Establezca el valor en -1 o en un número entero de como mínimo 604,800. Un valor de -1 indica que los metadatos no caducan.

Este valor no puede ser menor que el TTL de datos de series temporales. Si el TTL de datos es -1, este valor también debe ser -1.

Si configura un TTL finito, establezca allowUpdateAttributes en false.

allowUpdateAttributes (opcional)

boolean

Especifica si se pueden actualizar las columnas de atributos de los metadatos. Si el TTL de metadatos no es -1, este valor debe ser false.

Ejemplos

Actualización de configuraciones de metadatos de series temporales

El siguiente ejemplo configura los metadatos de series temporales para que nunca caduquen y permite la actualización de las columnas de atributos de los metadatos.

String tableName = "example_timeseries_table";
TimeseriesMetaOptions metaOptions = new TimeseriesMetaOptions();
metaOptions.setMetaTimeToLive(-1);
metaOptions.setAllowUpdateAttributes(true);

UpdateTimeseriesTableRequest request =
        new UpdateTimeseriesTableRequest(tableName);
request.setTimeseriesMetaOptions(metaOptions);

timeseriesClient.updateTimeseriesTable(request);