Tous les produits
Search
Centre de documentation

Tablestore:SearchQuery

Dernière mise à jour :Aug 18, 2026

SearchQuery définit les configurations de requête spécifiées lors de l'appel à l'opération Search des index de recherche.

Structure des données

message SearchQuery {
    optional int32 offset = 1;
    optional int32 limit = 2;
    optional Query query = 4;
    optional Collapse collapse = 5;
    optional Sort sort = 6;
    optional bool getTotalCount = 8;
    optional bytes token = 9;
    optional Aggregations aggs = 10;
    optional GroupBys group_bys = 11;
    optional Highlight highlight = 12;
    optional SearchFilter filter = 14;
}

Nom

Type

Obligatoire

Description

offset

int32

Non

La position à partir de laquelle la requête actuelle commence.

limit

int32

Non

Le nombre maximal de lignes que vous souhaitez que la requête actuelle renvoie.

query

Query

Oui

La configuration de la requête.

collapse

Collapse

Non

Regroupe les résultats renvoyés en fonction de la colonne spécifiée.

sort

Sort

Non

La méthode de tri des résultats.

getTotalCount

bool

Non

Indique s'il faut renvoyer le nombre total de lignes correspondant aux conditions de la requête. La valeur par défaut de ce paramètre est false, ce qui signifie que le nombre total de lignes correspondantes n'est pas renvoyé.

Le renvoi du nombre total de lignes correspondantes dégrade les performances de la requête.

token

bytes

Non

Si Tablestore ne peut pas lire toutes les données répondant aux conditions de la requête, il renvoie next_token. Vous pouvez utiliser next_token pour poursuivre la lecture des données suivantes.

aggs

Aggregations

Non

Les configurations d'agrégation.

group_bys

GroupBys

Non

Les configurations de regroupement.

highlight

Highlight

Non

Les configurations de mise en surbrillance.

filter

SearchFilter

Non

Un post-filtre pour la phase de requête. Le filtre est appliqué aux résultats de la requête. Les agrégations et les regroupements sont exécutés uniquement sur les données filtrées.

Opérations connexes

Search