Tous les produits
Search
Centre de documentation

Tablestore:TableOptions

Dernière mise à jour :Sep 22, 2026

TableOptions définit la configuration 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. L'écriture réussit 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 aucune mise à 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. Conservez la valeur par défaut true pour allow_update.