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

# 수식 표현식에서 집계 함수 사용
<a name="expression-aggregation-functions"></a>

[지표](metrics.md)에 한해, 다음 함수를 사용하여 각 시간 간격 동안 입력 값을 집계하고 단일 출력 값을 계산할 수 있습니다. 집계 함수는 연결된 자산의 데이터를 집계할 수 없습니다.

집계 함수 인수는 [변수](expression-variables.md), [숫자 리터럴](expression-literals.md#number-literal-definition), [시간 함수](expression-temporal-functions.md), 중첩 표현식 또는 집계 함수일 수 있습니다. 이 공식 `max(latest(x), latest(y), latest(z))`는 집계 함수를 인수로 사용하고 `x`, `y`, `z` 속성의 현재 최대 값을 반환합니다.

집계 함수에서 중첩 표현식을 사용할 수 있습니다. 중첩된 표현식을 사용할 때는 다음 규칙이 적용됩니다.
+ 각 인수에는 변수가 하나만 있을 수 있습니다.  
**Example**  

  예를 들어, `avg(x*(x-1))` 및 `sum(x/2 )/avg(y^2 )`가 지원됩니다.

  예를 들어, `min(x/y)`는 지원되지 않습니다.
+ 각 인수에는 다단계 중첩 표현식이 있을 수 있습니다.  
**Example**  

  예를 들어 `sum(avg(x^2 )/2)`은 지원됩니다.
+ 인수마다 변수가 다를 수 있습니다.  
**Example**  

  예를 들어 `sum(x/2, y*2)`은 지원됩니다.

**참고**  
표현식에 측정값이 포함된 경우는 측정값에 대해 현재 시간 간격의 마지막 값을 AWS IoT SiteWise 사용하여 집계를 계산합니다.
표현식에 속성이 포함된 경우는 속성의 최신 값을 AWS IoT SiteWise 사용하여 집계를 계산합니다.


| 함수 | 설명 | 
| --- | --- | 
| `avg(x0, ..., xn)` | 현재 시간 간격 동안 해당 변수 값의 평균을 반환합니다.<br /><a name="aggregation-function-no-output"></a>이 함수는 지정된 변수에 현재 시간 간격 동안 하나 이상의 데이터 요소가 있는 경우에만 데이터 포인트를 출력합니다. | 
| `sum(x0, ..., xn)` | 현재 시간 간격 동안 해당 변수 값의 합계를 반환합니다.<br /><a name="aggregation-function-no-output"></a>이 함수는 지정된 변수에 현재 시간 간격 동안 하나 이상의 데이터 요소가 있는 경우에만 데이터 포인트를 출력합니다. | 
| `min(x0, ..., xn)` | 현재 시간 간격 동안 해당 변수 값의 최소값을 반환합니다.<br /><a name="aggregation-function-no-output"></a>이 함수는 지정된 변수에 현재 시간 간격 동안 하나 이상의 데이터 요소가 있는 경우에만 데이터 포인트를 출력합니다. | 
| `max(x0, ..., xn)` | 현재 시간 간격 동안 해당 변수 값의 최대값을 반환합니다.<br /><a name="aggregation-function-no-output"></a>이 함수는 지정된 변수에 현재 시간 간격 동안 하나 이상의 데이터 요소가 있는 경우에만 데이터 포인트를 출력합니다. | 
| `count(x0, ..., xn)` | 현재 시간 간격 동안 해당 변수에 대한 총 데이터 포인트 수를 반환합니다. 조건을 충족하는 데이터 포인트 수를 계산하는 방법에 대한 자세한 내용은 [조건과 일치하는 데이터 포인트를 계산하려면 다음을 수행하세요.](expression-tutorials.md#count-filtered-data) 단원을 참조하세요.<br /><a name="aggregation-function-always-output"></a>이 함수는 모든 시간 간격에 대한 데이터 포인트를 계산합니다. | 
| `stdev(x0, ..., xn)` | 현재 시간 간격 동안 지정된 변수 값의 표준 편차를 반환합니다.<br />이 함수는 지정된 변수에 현재 시간 간격 동안 하나 이상의 데이터 요소가 있는 경우에만 데이터 포인트를 출력합니다. |