기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

FT.SEARCH 명령의 상위 집합으로, 쿼리 표현식으로 선택한 키의 상당 수를 추가로 처리할 수 있습니다.

**구문**

```
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]
```
+ FILTER, LIMIT, GROUPBY, SORTBY 및 APPLY 절을 원하는 순서대로 여러 번 반복할 수 있으며 자유롭게 결합할 수 있습니다. 이는 지정된 순서대로 적용되며, 한 절의 출력이 다음 절의 입력이 됩니다.
+ 위 구문에서 ‘속성’은 이 인덱스에 대해 [FT.CREATE](https://docs.aws.amazon.com/memorydb/latest/devguide/vector-search-commands-ft.create.html) 명령으로 선언된 필드이거나 이전 APPLY 절 또는 REDUCE 함수의 출력입니다.
+ LOAD 절은 인덱스에서 선언된 필드를 로드하는 것으로 제한됩니다. ‘LOAD \$1’는 인덱스에 선언된 모든 필드를 로드합니다.
+ 지원되는 리듀서 함수는 COUNT, COUNT\$1DISTINCTISH, SUM, MIN, MAX, AVG, STDDEV, QUANTILE, TOLIST, FIRST\$1VALUE, RANDOM\$1SAMPLE입니다. 자세한 내용은 [집계](https://redis.io/docs/interact/search-and-query/search/aggregations/)를 참조하세요.
+ LIMIT <offset> <count>: <offset>에서 시작하여 <count>로 이어지는 레코드를 유지하며, 다른 모든 레코드는 삭제됩니다.
+ PARAMS: 키 값 쌍 수의 2배입니다. 파라미터 키/값 쌍은 쿼리 표현식 내에서 참조할 수 있습니다.

**반환**

배열 또는 오류 응답을 반환합니다.
+ 작업이 성공적으로 완료되면 배열을 반환합니다. 첫 번째 요소는 특별한 의미가 없는 정수입니다(무시해야 함). 나머지 요소는 마지막 단계에서 출력된 결과입니다. 각 요소는 필드 이름 및 값 쌍의 배열입니다.
+ 인덱스가 다시 채워지고 있는 경우 명령은 즉시 오류 응답을 반환합니다.
+ 제한 시간에 도달하면 명령이 오류 응답을 반환합니다.