RANK BY Clause

Les résultats d’une requête incluent à la fois les lignes retournées par la requête et une valeur de classement pour chaque ligne si la colonne rank est incluse dans la clause SELECT. Les valeurs de classement sont calculées par le moteur de recherche et sont retournées sous forme d’entiers dans la plage de zéro à 1000. Pour rendre les résultats de classement plus significatifs, la requête peut contrôler la façon dont les valeurs de classement brutes sont calculées dans la clause RANK BY.

Cette rubrique est organisée comme suit :

• RANK BY Clause
• Fonction WEIGHT
• FONCTION COERCITION

RANK BY Clause

La syntaxe de la clause RANK BY est la suivante :

WHERE ( <search_condition> ) 
RANK BY [ ( ] <rank_specification> [ ) ]

La clause RANK BY est appliquée au search_condition immédiatement qui la précède, spécifiant en fait un rang inférieur ou supérieur pour les lignes retournées par cette condition de recherche par rapport aux lignes retournées par une autre condition de recherche. Les parenthèses entourant le search_condition sont obligatoires. Les parenthèses entourant la spécification de rang sont facultatives.

Plusieurs clauses RANK BY peuvent être appliquées à une seule condition. Vous pouvez inclure des clauses RANK BY supplémentaires l’une après l’autre à l’aide de parenthèses.

La partie rank_specification de la clause RANKBY identifie une ou plusieurs fonctions à appliquer aux valeurs de classement. La fonction WEIGHT applique un multiplicateur à la valeur de classement brut d’une ligne retournée. Plus le multiplicateur est petit, plus la valeur de classement résultante est faible. La fonction COERCION peut être utilisée pour multiplier, ajouter ou définir une valeur de classement spécifique pour une ligne retournée. Chaque spécification de classement peut inclure zéro ou une fonction WEIGHT et zéro ou plusieurs fonctions COERCITION. Si les fonctions WEIGHT et COERCION sont incluses dans une clause RANK BY, la fonction WEIGHT doit être la première.

Fonction WEIGHT

La syntaxe de la fonction WEIGHT est la suivante :

WEIGHT ( <weight_multipler> ) 

Le multiplicateur doit être une décimale comprise entre 0,001 et 1,000. La valeur de classement brut retournée par le prédicat de condition de recherche est multipliée par le multiplicateur de pondération pour définir une nouvelle valeur de classement.

Dans l’exemple suivant, la fonction WEIGHT donne aux documents avec le mot « Theresa » dans le champ System.Document.LastAuthor la moitié de la valeur de classement des documents avec « Theresa » dans le champ System.Author :

WHERE CONTAINS ( System.Author,'"Theresa"' ) 
         RANK BY WEIGHT ( 1.000 )
      OR
      CONTAINS ( System.Document.LastAuthor,'"Theresa"' ) 
         RANK BY WEIGHT ( 0.500 ) 

Il existe une limitation lors de l’utilisation de RANK BY WEIGHT : elle ne fonctionne pas avec les clauses CONTAINS qui utilisent des conditions booléennes ; par exemple, l’exemple suivant n’est pas autorisé :

CONTAINS ( System.Author,'"Theresa" OR "Teresa"' ) RANK BY WEIGHT ( 0.400 )

FONCTION COERCITION

La fonction de contrainte de classement peut être utilisée pour modifier la valeur de classement retournée par addition ou multiplication ou en lui attribuant une valeur spécifique.

La syntaxe de la fonction COERCION est la suivante :

COERCION ( <coercion_operation> , <coercion_value> )

La valeur de contrainte est une valeur entière.

Le tableau suivant décrit les paramètres d’opération de contrainte disponibles.

L’exemple suivant utilise la fonction COERCITION pour définir tous les documents avec « ordinateur » dans le titre pour qu’ils aient un rang de 1 000, tout en réduisant d’un quart le rang des documents contenant à la fois « ordinateur » et « software » dans le titre.

WHERE CONTAINS ( System.Title, 'computer' )
        RANK BY COERCION ( ABSOLUTE , 1000 )
        OR 
       CONTAINS ( System.Title, '"computer" AND "software"' )
        RANK BY COERCION ( MULTIPLY, 0.750 )