AGRÉGAT DE PIEDS

Il s'agit d'un sur-ensemble de la commande FT.SEARCH qui permet un traitement supplémentaire substantiel des clés sélectionnées par l'expression de requête.

Syntaxe

FT.AGGREGATE index query
  [LOAD * | [count field [field ...]]]
  [TIMEOUT timeout]
  [PARAMS count name value [name value ...]]
  [FILTER expression]
  [LIMIT offset num]  
  [GROUPBY count property [property ...] [REDUCE function count arg [arg ...] [AS name] [REDUCE function count arg [arg ...] [AS name] ...]] ...]] 
  [SORTBY count [ property ASC | DESC [property ASC | DESC ...]] [MAX num]] 
  [APPLY expression AS name]

• Les clauses FILTER, LIMIT, GROUPBY, SORTBY et APPLY peuvent être répétées plusieurs fois dans n'importe quel ordre et être librement mélangées. Ils sont appliqués dans l'ordre spécifié, la sortie d'une clause alimentant l'entrée de la clause suivante.

• Dans la syntaxe ci-dessus, une « propriété » est soit un champ déclaré dans la commande FT.CREATE pour cet index, SOIT la sortie d'une clause APPLY ou d'une fonction REDUCE précédente.

• La clause LOAD est limitée au chargement des champs déclarés dans l'index. « LOAD * » chargera tous les champs déclarés dans l'index.

• Les fonctions de réduction suivantes sont prises en charge : COUNT, COUNT_DISTINCTISH, SUM, MIN, MAX, AVG, STDDEV, QUANTILE, TOLIST, FIRST_VALUE et RANDOM_SAMPLE. Pour plus d'informations, voir Agrégations

• LIMITE <offset><count>: Conserve les enregistrements commençant à <offset>et se poursuivant jusqu'à<count>, tous les autres enregistrements sont supprimés.

• PARAMS : deux fois le nombre de paires clé-valeur. Les paires clé/valeur de paramètre peuvent être référencées à partir de l'expression de requête. Pour plus d'informations, voir Expression de requête de recherche vectorielle.

Retour

Renvoie un tableau ou une réponse d'erreur.

• Si l'opération aboutit, elle renvoie un tableau. Le premier élément est un entier sans signification particulière (doit être ignoré). Les autres éléments sont les résultats de la dernière étape. Chaque élément est un tableau de paires de noms de champs et de valeurs.

• Si l'index est en cours de remplissage, la commande renvoie immédiatement une réponse d'erreur.

• Si le délai est dépassé, la commande renvoie une réponse d'erreur.