Atualizar configurações de tabela de séries temporais - Tablestore SDK for Java - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisitos

Instale o Tablestore SDK for Java e inicialize um cliente de séries temporais.

Descrição

Chame updateTimeseriesTable para atualizar as configurações da tabela de séries temporais. Cada solicitação pode atualizar as configurações de dados ou de metadados, mas não ambas simultaneamente.

public UpdateTimeseriesTableResponse updateTimeseriesTable(UpdateTimeseriesTableRequest request)

O exemplo a seguir atualiza o TTL dos dados de séries temporais da tabela example_timeseries_table para três anos.

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 contém os seguintes parâmetros:

Nome	Tipo	Descrição
timeseriesTableName (obrigatório)	`String`	Nome da tabela de séries temporais cujas configurações serão atualizadas.
timeseriesTableOptions (opcional)	`TimeseriesTableOptions`	Configurações dos dados de séries temporais. Especifique `timeseriesTableOptions` ou `timeseriesMetaOptions`, mas não ambos.
timeseriesMetaOptions (opcional)	`TimeseriesMetaOptions`	Configurações dos metadados de séries temporais. Especifique `timeseriesTableOptions` ou `timeseriesMetaOptions`, mas não ambos.

Configurações de dados de séries temporais

timeseriesTableOptions é do tipo TimeseriesTableOptions e contém o seguinte parâmetro:

Nome

Tipo

Descrição

timeToLive (obrigatório)

int

TTL dos dados de séries temporais em segundos. Defina o valor como -1 ou um número inteiro maior ou igual a 86.400. O valor -1 indica que os dados não expiram.

O Tablestore exclui automaticamente os dados expirados.

Se o TTL dos metadados não for -1, este valor não poderá exceder o TTL dos metadados. Antes de definir este valor como -1, defina o TTL dos metadados como -1.

Configurações de metadados de séries temporais

timeseriesMetaOptions é do tipo TimeseriesMetaOptions. Especifique pelo menos um dos parâmetros a seguir. Um parâmetro omitido mantém seu valor atual.

Nome

Tipo

Descrição

metaTimeToLive (opcional)

int

TTL dos metadados de séries temporais em segundos. Defina o valor como -1 ou um número inteiro maior ou igual a 604.800. O valor -1 indica que os metadados não expiram.

Este valor não pode ser inferior ao TTL dos dados de séries temporais. Se o TTL dos dados for -1, este valor também deverá ser -1.

Ao configurar um TTL finito, defina allowUpdateAttributes como false.

allowUpdateAttributes (opcional)

boolean

Define se as colunas de atributos de metadados podem ser atualizadas. Se o TTL dos metadados não for -1, este valor deve ser false.

Exemplos

Atualizar configurações de metadados de séries temporais

O exemplo a seguir configura os metadados de séries temporais para nunca expirar e permite a atualização das colunas de atributos de metadados.

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);