Tous les produits
Search
Centre de documentation

OpenSearch:Transmission de paramètres personnalisés - clause kvpair

Dernière mise à jour :Aug 20, 2026

Utilisez la clause kvpair pour attribuer des valeurs aux champs référencés dans la partie modifiable d'une expression de tri. Vous transmettez ainsi les valeurs des champs à des fonctions de caractéristiques spécifiques via une clause de requête.

Description

La clause kvpairs respecte le format suivant : key1:value1,key2:value2

  • key1 désigne un champ et values1 sa valeur. Séparez le champ et sa valeur au sein d'une paire clé-valeur par deux-points (:).

  • Spécifiez plusieurs paires clé-valeur si nécessaire. Séparez-les par des virgules (,).

Notes d'utilisation

  • La clause kvpairs est facultative.

Exemples

Utilisez la clause de requête suivante pour rechercher les documents contenant « Zhejiang University ». Les documents récupérés sont agrégés selon le champ company_id. Une seule extraction est effectuée sur un unique document. Les autres documents sont ignorés et seul le document extrait est renvoyé.

query=default:'Zhejiang University'&&distinct=dist_key:company_id,dist_count:1,dist_times:1,reserved:false&&kvpairs=duniqfield:company_id

Utilisez la clause de requête ci-dessous pour rechercher les documents contenant « Zhejiang University » en appliquant la condition de correspondance 13=10:100=1. Dans ce cas, la fonction tag_match s'applique. La condition de correspondance cible un champ de tag de type INT_ARRAY. Ce champ contient plusieurs paires d'attributs. Les valeurs des attributs correspondant à une clé sont additionnées. Si plusieurs clés correspondent, la somme la plus élevée est conservée.

query=default:'Zhejiang University'&&kvpairs=query_key:13=10:100=1  // The fine sort expression is tag_match(query_key, tags, sum, max, true, true).