Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# FT.AGGREGATE
<a name="vector-search-commands-ft.aggregate"></a>

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](https://docs.aws.amazon.com/memorydb/latest/devguide/vector-search-commands-ft.create.html) 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 \$1» caricherà tutti i campi dichiarati nell'indice. 
+ Sono supportate le seguenti funzioni di riduzione: COUNT, COUNT\$1DISTINCTISH, SUM, MIN, MAX, AVG, STDDEV, QUANTILE, TOLIST, FIRST\$1VALUE e RANDOM\$1SAMPLE. [Per ulteriori informazioni, vedere Aggregazioni](https://redis.io/docs/interact/search-and-query/search/aggregations/)
+ 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 key/value coppie di parametri dall'interno dell'espressione di query.

**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.