Tous les produits
Search
Centre de documentation

Tablestore:Update the configurations of a search index

Dernière mise à jour :Sep 20, 2026

Mettez à jour la durée de vie (TTL) d'un index de recherche à l'aide du SDK Tablestore pour Node.js en appelant l'opération UpdateSearchIndex.

Prérequis

Notes d'utilisation

Lorsque vous configurez la durée de vie (TTL) d'un index de recherche, tenez compte des points suivants :

  • La TTL de la table de données et celle de l'index de recherche sont indépendantes. La TTL de l'index de recherche ne peut pas dépasser celle de la table de données. Si vous souhaitez réduire simultanément la TTL de la table de données et de l'index de recherche, mettez d'abord à jour la TTL de l'index de recherche avant de modifier celle de la table de données.

  • L'index de recherche supprime les données expirées quotidiennement. Entre l'expiration des données et l'exécution de la tâche de nettoyage suivante, ces données peuvent encore apparaître dans les résultats de requête.

  • Après avoir réduit la TTL, le système supprime les données historiques expirées lors des tâches de nettoyage ultérieures.

Paramètres

Paramètre

Description

tableName (obligatoire)

Nom de la table de données.

indexName (obligatoire)

Nom de l'index de recherche.

timeToLive (obligatoire)

Durée de vie (TTL) de l'index de recherche, exprimée en secondes. Définissez cette valeur sur -1 pour que les données n'expirent jamais. Utilisez une valeur entière positive (int32) pour définir une période d'expiration fixe. La valeur maximale int32 correspond à environ 68 ans.

Exemples

L'exemple suivant définit la TTL d'un index de recherche sur sept jours (604 800 secondes) :

let params = {
    tableName: '<TABLE_NAME>',
    indexName: '<SEARCH_INDEX_NAME>',
    timeToLive: 604800,  // 7 days in seconds (7 x 24 x 60 x 60)
}
client.updateSearchIndex(params, function (err, data) {
    if (err) {
        console.log('updateSearchIndex error:', err.toString());
    } else {
        console.log('updateSearchIndex success:', data);
    }
});

Pour calculer la valeur timeToLive correspondant à une autre durée, multipliez le nombre de jours par 86400 (nombre de secondes par jour). Par exemple, pour 30 jours, la valeur est 2592000.

FAQ

[[Que faire si le message d'erreur « [table ttl] must be bigger than or equal search index ttl » s'affiche lors de la modification de la TTL d'une table de données ?](t2633375.xdita#)](t2633375.xdita#)

Références