Tous les produits
Search
Centre de documentation

Tablestore:MatchQuery

Dernière mise à jour :Aug 19, 2026

MatchQuery définit la configuration d'une requête de correspondance. Utilisez ce type de requête pour interroger les données d'une table en vous basant sur des correspondances approximatives.

Structure des données

message MatchQuery {
    optional string field_name = 1;
    optional string text = 2;
    optional int32 minimum_should_match = 3;
    optional QueryOperator operator = 4;
    optional float weight = 5;
}

Paramètre

Type

Obligatoire

Description

field_name

string

Oui

Nom de la colonne à interroger.

La colonne doit être de type TEXT.

text

string

Oui

Mot-clé utilisé pour faire correspondre la valeur de la colonne lors d'une requête de correspondance.

Si la colonne interrogée est de type TEXT, le mot-clé est découpé en plusieurs jetons selon le type d'analyseur spécifié lors de la création de l'index de recherche. Par défaut, si aucun type d'analyseur n'est spécifié, une tokenisation par mot unique est appliquée.

Par exemple, si la colonne interrogée est de type TEXT avec une tokenisation par mot unique et que vous utilisez « this is » comme mot-clé, les résultats incluront des valeurs telles que « ..., this is tablestore », « is this tablestore », « tablestore is cool », « this » et « is ».

minimum_should_match

int32

Non

Nombre minimal de jetons correspondants que doit contenir la valeur d'une colonne. Ce paramètre s'utilise conjointement avec l'opérateur logique OR.

Une ligne n'est renvoyée que si la valeur de la colonne field_name contient au moins le nombre minimal de jetons correspondants.

operator

QueryOperator

Non

Opérateur de requête. Spécifiez l'opérateur AND ou OR. Par défaut, l'opérateur logique OR est utilisé, ce qui signifie qu'une ligne satisfait aux conditions de requête si la valeur de la colonne contient au moins le nombre minimal de jetons.

weight

float

Non

Configuration du poids associé à la condition de requête.