FT.AGGREGATE

Como superconjunto del comando FT.SEARCH, permite un procesamiento adicional sustancial de las claves seleccionadas por la expresión de consulta.

Sintaxis

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]

• Las cláusulas FILTER, LIMIT, GROUPBY, SORTBY y APPLY se pueden repetir varias veces en cualquier orden y mezclarse libremente. Se aplican en el orden especificado y el resultado de una cláusula alimenta la entrada de la siguiente cláusula.

• En la sintaxis anterior, una “propiedad” es un campo declarado en el comando FT.CREATE para este índice O el resultado de una cláusula APPLY o función REDUCE anterior.

• La cláusula LOAD se limita a cargar campos que se han declarado en el índice. “LOAD *” cargará todos los campos declarados en el índice.

• Se admiten las siguientes funciones reductoras: COUNT, COUNT_DISTINCTISH, SUM, MIN, MAX, AVG, STDDEV, QUANTILE, TOLIST, FIRST_VALUE y RANDOM_SAMPLE. Para obtener más información, consulte Agregaciones.

• LIMIT <offset><count>: conserva los registros que comienzan en <offset>y continúan hasta <count>, todos los demás registros se descartan.

• PARAMS: dos veces la cantidad de pares de valores clave. Se puede hacer referencia a los pares clave/valor de los parámetros desde la expresión de consulta. Para obtener más información, consulte Expresión de consulta de búsqueda vectorial.

Devolución

Devuelve una matriz o una respuesta de error.

• Si la operación se completa correctamente, devuelve una matriz. El primer elemento es un número entero sin ningún significado particular (debe ignorarse). Los elementos restantes son los resultados obtenidos en la última etapa. Cada elemento es una matriz de pares de nombre y valor de campo.

• Si el índice está en proceso de reposición, el comando devuelve inmediatamente una respuesta de error.

• Si se agota el tiempo de espera, el comando devuelve una respuesta de error.