Utilisez une requête de correspondance d'expression dans le SDK Tablestore pour Go afin de faire correspondre une expression dans un champ Text en fonction de l'ordre et de la position des jetons.
Prérequis
Installez le SDK Tablestore Go et initialisez un client.
Description
Une requête de correspondance d'expression tokenize le texte de la requête et exige que les jetons apparaissent dans l'ordre spécifié dans un champ Text. Le paramètre Slop contrôle le nombre de positions que les jetons peuvent couvrir. Si un champ Text utilise l'analyseur flou, une requête de correspondance d'expression peut fournir une correspondance floue similaire à une requête avec caractère générique, mais avec une latence de requête plus faible.
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.MatchPhraseQuery{FieldName: "title", Text: "go search", Slop: proto.Int32(0)}
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 |
Le nom de la table de données. |
|
IndexName (obligatoire) |
string |
Le nom de l'index de recherche. |
|
SearchQuery (obligatoire) |
search.SearchQuery |
La condition de requête et les configurations de requête courantes. |
|
ColumnsToGet (facultatif) |
*tablestore.ColumnsToGet |
La 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 |
Le 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 la 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.MatchPhraseQuery et contient les paramètres suivants.
|
Nom |
Type |
Description |
|
FieldName (obligatoire) |
string |
Le nom du champ Text à interroger. |
|
Text (obligatoire) |
string |
Le texte de l'expression à faire correspondre. |
|
Slop (facultatif) |
*int32 |
Le nombre de positions que les jetons peuvent couvrir. Valeur par défaut : 0. |
|
Weight (facultatif) |
*float32 |
Le 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 |
Les 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 |
Le nombre total de lignes correspondantes. La valeur dépend de SetGetTotalCount. |
|
Rows |
[]*tablestore.Row |
Les lignes renvoyées par la requête actuelle. Le nombre ne dépasse pas la valeur spécifiée par SetLimit. |
|
SearchHits |
[]*tablestore.SearchHit |
Les 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 |
Le 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 |
Les résultats d'agrégation. |
|
GroupByResults |
search.GroupByResults |
Les résultats de regroupement. |