Tous les produits
Search
Centre de documentation

Tablestore:CreateSearchIndex

Dernière mise à jour :Aug 19, 2026

Crée un index de recherche.

Remarque

Pour plus d'informations sur les index de recherche, consultez la rubrique Présentation.

Notes d'utilisation

Avant de créer un index de recherche, vérifiez que le nombre maximal de versions de la table de données est défini sur 1 et que la durée de vie (TTL) de la table de données respecte l'une des conditions suivantes :

  • La TTL de la table de données est définie sur -1, ce qui indique que les données de la table n'expirent jamais.

  • La TTL de la table de données est définie sur une valeur différente de -1 et les opérations de mise à jour sur la table de données sont interdites.

Syntaxe de la requête

message CreateSearchIndexRequest {
    required string table_name = 1;
    required string index_name = 2;
    optional IndexSchema schema = 3;
    optional string source_index_name = 4;
    optional int32 time_to_live = 5; // unit is seconds
}

Paramètre

Type

Obligatoire

Description

table_name

string

Oui

Nom de la table de données.

index_name

string

Oui

Nom de l'index de recherche.

schema

IndexSchema

Oui

Schéma de l'index de recherche.

source_index_name

string

Non

Nom de l'index de recherche source. Ce paramètre est requis uniquement pour modifier dynamiquement un schéma.

time_to_live

int32

Non

Durée de vie (TTL) de l'index de recherche. La TTL spécifie la durée de conservation des données. Valeur par défaut : -1. Unité : secondes.

Si la période de conservation dépasse la valeur du paramètre time_to_live, Tablestore supprime automatiquement les données expirées.

La valeur minimale du paramètre time_to_live est 86400, soit un jour. Une valeur de -1 indique que les données n'expirent jamais.

Pour plus d'informations sur la TTL des index de recherche, consultez la rubrique Spécifier la TTL d'un index de recherche.

Syntaxe de la réponse

message CreateSearchIndexResponse {
}

  • HTTP 200 : l'appel a réussi.

  • HTTP 400 ou 500 : l'appel a échoué.

    La réponse inclut un message d'erreur. Pour plus d'informations, consultez la rubrique Erreur.

Utiliser les SDK Tablestore

Utilisez les SDK Tablestore suivants pour créer un index de recherche :