FT.AGGREGATE

Un superset del comando FT.SEARCH, consente un'elaborazione aggiuntiva sostanziale delle chiavi selezionate dall'espressione di query.

Sintassi

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]

• Le clausole FILTER, LIMIT, GROUPBY, SORTBY e APPLY possono essere ripetute più volte in qualsiasi ordine e possono essere mescolate liberamente. Vengono applicate nell'ordine specificato con l'output di una clausola che alimenta l'input della clausola successiva.

• Nella sintassi precedente, una «proprietà» è un campo dichiarato nel comando FT.CREATE per questo indice OPPURE l'output di una precedente clausola APPLY o funzione REDUCE.

• La clausola LOAD si limita al caricamento di campi dichiarati nell'indice. «LOAD *» caricherà tutti i campi dichiarati nell'indice.

• Sono supportate le seguenti funzioni di riduzione: COUNT, COUNT_DISTINCTISH, SUM, MIN, MAX, AVG, STDDEV, QUANTILE, TOLIST, FIRST_VALUE e RANDOM_SAMPLE. Per ulteriori informazioni, vedere Aggregazioni

• LIMITE <offset><count>: Conserva i record a partire da <offset>e fino a<count>, tutti gli altri record vengono eliminati.

• PARAMETRI: due volte il numero di coppie chiave-valore. È possibile fare riferimento alle coppie chiave/valore del parametro dall'interno dell'espressione di query. Per ulteriori informazioni, vedete Espressione di interrogazione di ricerca vettoriale.

Valori restituiti

Restituisce una matrice o una risposta di errore.

• Se l'operazione viene completata correttamente, restituisce un array. Il primo elemento è un numero intero senza un significato particolare (deve essere ignorato). Gli elementi rimanenti sono i risultati prodotti dall'ultima fase. Ogni elemento è una matrice di coppie di nomi di campo e valori.

• Se l'indice è in corso di riempimento, il comando restituisce immediatamente una risposta di errore.

• Se viene raggiunto il timeout, il comando restituisce una risposta di errore.