Tous les produits
Search
Centre de documentation

Tablestore:TableOptions

Dernière mise à jour :Aug 18, 2026

TableOptions définit les configurations au niveau de la table, notamment la durée de conservation des données (TTL), le nombre maximal de versions et les contraintes de décalage de version.

Structure des données

message TableOptions {
    optional int32 time_to_live = 1; 
    optional int32 max_versions = 2; 
    optional int64 deviation_cell_version_in_sec = 5; 
    optional bool allow_update = 6;
    optional bool update_full_row = 7;
}

Paramètre

Type

Obligatoire

Description

time_to_live

int32

Non

Durée de conservation des données, en secondes. Tablestore supprime automatiquement les données dont l'âge dépasse cette période.

Valeurs valides : entier supérieur ou égal à 86400 (un jour), ou -1 (les données n'expirent jamais).

max_versions

int32

Non

Nombre maximal de versions conservées par colonne d'attribut. Tablestore supprime automatiquement les versions les plus anciennes lorsque cette limite est dépassée.

deviation_cell_version_in_sec

int64

Non

Décalage de version maximal, en secondes. Une requête d'écriture aboutit uniquement si le numéro de version (horodatage) de chaque colonne se situe dans cet intervalle par rapport à l'heure système actuelle.

Plage d'horodatage valide pour une colonne d'attribut : [max{write_time - max_version_offset, write_time - TTL}, write_time + max_version_offset).

allow_update

bool

Non

Indique si l'opération UpdateRow est autorisée sur cette table. Valeur par défaut : true.

Définissez ce paramètre sur false si la table ne nécessite pas de mises à jour et que la fonctionnalité TTL de l'index de recherche est activée.

update_full_row

bool

Non

Indique si UpdateRow remplace la ligne entière ou uniquement les colonnes spécifiées. Valeur par défaut : false (seules les colonnes spécifiées sont mises à jour).

Définissez ce paramètre sur true si des mises à jour de données sont nécessaires et que la fonctionnalité TTL de l'index de recherche ou la fonctionnalité de table globale est activée. Laissez allow_update avec sa valeur par défaut true.