Update time series table configurations - Tablestore SDK for Java - Tablestore

Utilisez le SDK Tablestore pour Java afin de mettre à jour la durée de conservation (TTL) des données et des métadonnées de séries temporelles, et d'indiquer si les colonnes d'attributs de métadonnées sont modifiables.

Prérequis

Installez le SDK Tablestore pour Java et initialisez un client de séries temporelles.

Description

Appelez la méthode updateTimeseriesTable pour mettre à jour les configurations d'une table de séries temporelles. Chaque requête met à jour soit les configurations des données, soit celles des métadonnées, mais pas les deux simultanément.

public UpdateTimeseriesTableResponse updateTimeseriesTable(UpdateTimeseriesTableRequest request)

L'exemple suivant définit la durée de conservation (TTL) des données de séries temporelles de la table example_timeseries_table sur trois ans.

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

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

timeseriesClient.updateTimeseriesTable(request);

Paramètres

L'objet UpdateTimeseriesTableRequest contient les paramètres suivants.

Nom

Type

Description

timeseriesTableName (obligatoire)

String

Nom de la table de séries temporelles dont vous souhaitez mettre à jour les configurations.

timeseriesTableOptions (facultatif)

TimeseriesTableOptions

Configurations des données de séries temporelles. Spécifiez soit timeseriesTableOptions, soit timeseriesMetaOptions, mais pas les deux.

timeseriesMetaOptions (facultatif)

TimeseriesMetaOptions

Configurations des métadonnées de séries temporelles. Spécifiez soit timeseriesTableOptions, soit timeseriesMetaOptions, mais pas les deux.

Configurations des données de séries temporelles

Le paramètre timeseriesTableOptions est de type TimeseriesTableOptions et contient le paramètre suivant.

Nom

Type

Description

timeToLive (obligatoire)

int

Durée de conservation (TTL) des données de séries temporelles, en secondes. Définissez la valeur sur -1 ou sur un entier supérieur ou égal à 86 400. Une valeur de -1 signifie que les données n'expirent jamais.

Tablestore supprime automatiquement les données expirées.

Si la durée de conservation des métadonnées n'est pas -1, cette valeur ne peut pas dépasser la durée de conservation des métadonnées. Avant de définir cette valeur sur -1, définissez la durée de conservation des métadonnées sur -1.

Configurations des métadonnées de séries temporelles

Le paramètre timeseriesMetaOptions est de type TimeseriesMetaOptions. Spécifiez au moins l'un des paramètres suivants. Tout paramètre omis conserve sa valeur actuelle.

Nom

Type

Description

metaTimeToLive (facultatif)

int

Durée de conservation (TTL) des métadonnées de séries temporelles, en secondes. Définissez la valeur sur -1 ou sur un entier supérieur ou égal à 604 800. Une valeur de -1 signifie que les métadonnées n'expirent jamais.

Cette valeur ne peut pas être inférieure à la durée de conservation des données de séries temporelles. Si la durée de conservation des données est -1, cette valeur doit également être -1.

Si vous configurez une durée de conservation limitée, définissez allowUpdateAttributes sur false.

allowUpdateAttributes (facultatif)

boolean

Indique si les colonnes d'attributs de métadonnées sont modifiables. Si la durée de conservation des métadonnées n'est pas -1, cette valeur doit être false.

Exemples

Mettre à jour les configurations des métadonnées de séries temporelles

L'exemple suivant configure les métadonnées de séries temporelles pour qu'elles n'expirent jamais et autorise la mise à jour des colonnes d'attributs de métadonnées.

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