Utilisez une requête de correspondance dans le SDK Tablestore pour Go afin de tokeniser le texte de la requête et de faire correspondre les jetons dans un champ Text.
Prérequis
Installez le SDK Tablestore pour Go et initialisez un client.
Description
Une requête de correspondance tokenize le texte de la requête à l'aide de l'analyseur configuré pour le champ d'index et combine les jetons selon les paramètres Operator et MinShouldMatch. Utilisez cette requête pour effectuer une recherche en texte intégral sur les champs Text.
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.MatchQuery{FieldName: "title", Text: "go search", Operator: search.QueryOperator_OR.Enum()}
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. |
|
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 |
Spécifie la condition de requête. |
|
SetOffset (facultatif) |
int32 |
Spécifie 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 |
Spécifie 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 |
Spécifie 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 |
Spécifie 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 les jetons. |
|
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.MatchQuery et contient les paramètres suivants.
|
Nom |
Type |
Description |
|
FieldName (obligatoire) |
string |
Nom du champ Text à interroger. |
|
Text (obligatoire) |
string |
Texte de la requête, tokenisé à l'aide de l'analyseur configuré pour le champ. |
|
Operator (facultatif) |
*search.QueryOperator |
Opérateur logique entre les jetons. Valeurs valides : |
|
MinShouldMatch (facultatif) |
*string |
Nombre ou pourcentage minimal de jetons devant correspondre, par exemple |
|
Weight (facultatif) |
*float32 |
Poids de pertinence de la condition de requête. |
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 simultanément. |
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. |