Utilisez une requête par préfixe dans le SDK Tablestore pour Go pour trouver les valeurs commençant par un préfixe spécifié.
Prérequis
Installez le SDK Tablestore pour Go et initialisez un client.
Description
Une requête par préfixe trouve les valeurs commençant par le préfixe spécifié. Pour un champ Text, la requête s'applique aux termes tokenisés plutôt qu'à la chaîne d'origine complète. La correspondance est sensible à la casse.
func (client *tablestore.TableStoreClient) Search(request *tablestore.SearchRequest) (*tablestore.SearchResponse, error)L'exemple suivant interroge les données et renvoie jusqu'à 10 lignes ainsi que le nombre total de lignes correspondantes.
tableName := "example_table"
indexName := "example_index"
query := &search.PrefixQuery{FieldName: "category", Prefix: "book-"}
searchQuery := search.NewSearchQuery().
SetQuery(query).
SetLimit(10).
SetGetTotalCount(true)
response, err := client.Search(&tablestore.SearchRequest{
TableName: tableName,
IndexName: indexName,
SearchQuery: searchQuery,
ColumnsToGet: &tablestore.ColumnsToGet{
ReturnAllFromIndex: true,
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(response.TotalCount)
fmt.Println(response.Rows)Paramètres
Requête de recherche
Le paramètre request est de type tablestore.SearchRequest et contient les paramètres suivants.
|
Nom |
Type |
Description |
|
TableName (obligatoire) |
string |
Nom de la table de données. |
|
IndexName (obligatoire) |
string |
Nom de l'index de recherche. |
|
SearchQuery (obligatoire) |
search.SearchQuery |
Condition de requête et configurations courantes de la requête. |
|
ColumnsToGet (facultatif) |
*tablestore.ColumnsToGet |
Configuration des colonnes à renvoyer. Si ce paramètre est omis, seules les colonnes de clé primaire sont renvoyées. |
|
RoutingValues (facultatif) |
[]*tablestore.PrimaryKey |
Valeurs de clé primaire pour les champs de routage personnalisé. Omettez ce paramètre si le routage personnalisé n'est pas configuré. |
|
TimeoutMs (facultatif) |
*int32 |
Délai d'expiration de la requête en millisecondes. |
Configuration de la requête
Créez une configuration de requête en appelant search.NewSearchQuery() et configurez-la à l'aide des méthodes suivantes.
|
Nom |
Type |
Description |
|
SetQuery (obligatoire) |
search.Query |
Définit la condition de requête. |
|
SetOffset (facultatif) |
int32 |
Définit la position de départ. Valeur par défaut : 0. Pour la pagination basée sur le décalage, Offset + Limit ne peut pas dépasser 100 000. |
|
SetLimit (facultatif) |
int32 |
Définit le nombre maximal de lignes à renvoyer. Valeur par défaut : 10. Valeur maximale : 100. Une valeur de 0 ne renvoie aucune ligne. |
|
SetHighlight (facultatif) |
*search.Highlight |
Configure les résumés et la mise en surbrillance pour les champs Text. Pour plus d'informations, consultez Résumé et mise en surbrillance. |
|
SetCollapse (facultatif) |
*search.Collapse |
Regroupe les résultats de la requête. Pour plus d'informations, consultez Regrouper les résultats de requête. |
|
SetSort (facultatif) |
*search.Sort |
Définit l'ordre de tri des résultats. Pour plus d'informations, consultez Trier et paginer les résultats. |
|
SetGetTotalCount (facultatif) |
bool |
Indique s'il faut compter toutes les lignes correspondantes. Valeur par défaut : false. |
|
SetToken (facultatif) |
[]byte |
Définit la valeur NextToken renvoyée par la réponse précédente. Cette méthode efface Sort car le jeton contient les conditions de tri de la page précédente. Ne spécifiez pas Offset lorsque vous utilisez la pagination basée sur un jeton. |
|
SetSearchFilter (facultatif) |
*search.SearchFilter |
Applique un filtre post-requête. Pour plus d'informations, consultez Utiliser des filtres post-requête. |
|
Aggregation (facultatif) |
...search.Aggregation |
Configure les agrégations. Pour plus d'informations, consultez Agrégation. |
|
GroupBy (facultatif) |
...search.GroupBy |
Configure le regroupement. Pour plus d'informations, consultez Agrégation. |
Condition de requête
La requête est de type search.PrefixQuery et contient les paramètres suivants.
|
Nom |
Type |
Description |
|
FieldName (obligatoire) |
string |
Nom du champ d'index à interroger. |
|
Prefix (obligatoire) |
string |
Préfixe à faire correspondre. |
Colonnes à renvoyer
Le paramètre request.ColumnsToGet est de type tablestore.ColumnsToGet et contient les paramètres suivants.
|
Nom |
Type |
Description |
|
Columns (facultatif) |
[]string |
Colonnes d'attribut à renvoyer. Ce paramètre prend effet uniquement lorsque ReturnAll et ReturnAllFromIndex sont tous deux définis sur false. |
|
ReturnAll (facultatif) |
bool |
Indique s'il faut renvoyer toutes les colonnes d'attribut de la table de données. Valeur par défaut : false. |
|
ReturnAllFromIndex (facultatif) |
bool |
Indique s'il faut renvoyer toutes les colonnes d'attribut indexées. Valeur par défaut : false. Ne définissez pas ce paramètre et ReturnAll sur true en même temps. |
Réponse
La méthode Search renvoie une valeur tablestore.SearchResponse. Le tableau suivant décrit les champs métier principaux.
|
Nom |
Type |
Description |
|
TotalCount |
int64 |
Nombre total de lignes correspondantes. La valeur dépend de SetGetTotalCount. |
|
Rows |
[]*tablestore.Row |
Lignes renvoyées par la requête actuelle. Le nombre ne dépasse pas la valeur spécifiée par SetLimit. |
|
SearchHits |
[]*tablestore.SearchHit |
Résultats de recherche. Lisez ce champ lorsque vous utilisez la mise en surbrillance, les hits internes imbriqués ou les scores de pertinence. |
|
NextToken |
[]byte |
Jeton pour la page suivante. Si la valeur n'est pas vide, transmettez-la à la requête suivante. |
|
IsAllSuccess |
bool |
Indique si toutes les partitions d'index ont été interrogées. Si la valeur est false, des résultats partiels sont renvoyés et TotalCount peut être inférieur au nombre réel de lignes correspondantes. |
|
AggregationResults |
search.AggregationResults |
Résultats d'agrégation. |
|
GroupByResults |
search.GroupByResults |
Résultats de regroupement. |