Tous les produits
Search
Centre de documentation

Tablestore:Query search index information

Dernière mise à jour :Aug 20, 2026

Utilisez le SDK Tablestore pour Python afin d'interroger les champs, les configurations, la durée de vie (TTL) et l'état de synchronisation des données d'un index de recherche.

Prérequis

Installez le SDK Tablestore pour Python et initialisez un client.

Description

Appelez la méthode describe_search_index pour interroger les configurations et l'état de synchronisation des données d'un index de recherche.

def describe_search_index(
    self,
    table_name,
    index_name,
    include_sync_stat=True,
)

L'exemple suivant interroge l'index example_index de la table example_table et affiche sa durée de vie (TTL), ses champs d'index ainsi que la phase de synchronisation des données.

index_meta, sync_stat = client.describe_search_index(
    "example_table",
    "example_index",
)

print(index_meta.time_to_live)
for field_schema in index_meta.fields:
    print(field_schema.field_name)

if sync_stat is not None:
    print(sync_stat.sync_phase)

Paramètres

La méthode describe_search_index accepte les paramètres suivants.

Nom

Type

Description

table_name (obligatoire)

str

Le nom de la table.

index_name (obligatoire)

str

Le nom de l'index de recherche.

include_sync_stat (facultatif)

bool

Indique s'il faut renvoyer l'état de synchronisation des données. Valeur par défaut : True. Si vous définissez ce paramètre sur False, le champ sync_stat de la réponse est None.

Réponse

La méthode describe_search_index renvoie un tuple contenant les informations suivantes.

Champ

Type

Description

index_meta

SearchIndexMeta

Les champs de l'index, les paramètres de l'index, les paramètres de prétri et la durée de vie (TTL).

sync_stat

SyncStat

L'état de synchronisation des données. Si include_sync_stat est défini sur False, ce champ est None.

Métadonnées de l'index de recherche

L'objet index_meta est une instance de SearchIndexMeta qui contient les champs suivants.

Champ

Type

Description

fields

List[FieldSchema]

Les champs de l'index. Pour la structure de l'objet, consultez la rubrique Créer un index de recherche.

index_setting

IndexSetting

Les paramètres de l'index.

index_sort

Sort

Les paramètres de prétri.

time_to_live

int

La durée de vie (TTL) des données de l'index, en secondes. Une valeur de -1 indique que les données n'expirent pas.

État de synchronisation des données

L'objet sync_stat est une instance de SyncStat qui contient les champs suivants.

Champ

Type

Description

sync_phase

SyncPhase

La phase de synchronisation des données. FULL indique une synchronisation complète, tandis que INCR indique une synchronisation incrémentielle.

current_sync_timestamp

int

L'horodatage actuel de la synchronisation des données.