기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 에서 자산 속성 집계 쿼리 AWS IoT SiteWise
AWS IoT SiteWise 는 여러 시간 간격으로 계산된 기본 지표 집합인 집계된 자산 속성 값을 자동으로 계산합니다.는 자산 속성에 대해 매분, 시간 및 일마다 다음 집계를 AWS IoT SiteWise 계산합니다.
+ **average(평균)** – 시간 간격 동안 속성 값의 평균입니다.
+ **count(개수)** – 일정 기간에 걸친 속성의 데이터 포인트 수입니다.
+ **maximum(최대)** – 시간 간격 동안 속성 값의 최대값입니다.
+ **minimum(최소)** – 시간 간격 동안 속성 값의 최소값입니다.
+ **standard deviation(표준 편차)** – 시간 간격 동안 속성 값의 표준 편차입니다.
+ **sum(합계)** – 시간 간격 동안 속성 값의 합계입니다.
문자열 및 부울과 같은 숫자가 아닌 속성의 경우는 개수 집계만 AWS IoT SiteWise 계산합니다.
자산 데이터에 대한 사용자 지정 지표를 계산할 수도 있습니다. 지표 속성을 사용하여 그 작업에만 해당되는 집계를 정의할 수 있습니다. 지표 속성은 AWS IoT SiteWise API에 대해 사전 계산되지 않은 추가 집계 함수와 시간 간격을 제공합니다. 자세한 내용은 [속성과 기타 자산에서 데이터 집계(지표)](metrics.md) 단원을 참조하십시오.
**Topics**
+ [자산 속성에 대한 집계(API)](#aggregates-api)
+ [자산 속성에 대한 집계를 쿼리하려면(AWS CLI) 다음을 수행하세요.](#aggregates-cli)
## 자산 속성에 대한 집계(API)
AWS IoT SiteWise API를 사용하여 자산 속성에 대한 집계를 가져옵니다.
[GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html) 작업을 사용하여 자산 속성의 집계를 쿼리합니다.
자산 속성을 식별하려면 다음 중 하나를 지정합니다.
+ 데이터를 보낼 자산 속성의 `assetId` 및 `propertyId`
+ 데이터 스트림 별칭(예: `/company/windfarm/3/turbine/7/temperature`)인 `propertyAlias`. 이 옵션을 사용하려면 먼저 자산 속성의 별칭을 설정해야 합니다. 속성 별칭을 설정하려면 [에 대한 데이터 스트림 관리 AWS IoT SiteWise](manage-data-streams.md) 섹션을 참조하세요.
다음 필수 파라미터를 전달해야 합니다.
+ `aggregateTypes` – 검색할 집계 목록입니다. `AVERAGE`, `COUNT`, `MAXIMUM`, `MINIMUM`, `STANDARD_DEVIATION`, `SUM` 중 하나를 지정할 수 있습니다.
+ `resolution` - 지표를 검색할 시간 간격: `1m` (1분), `15m` (15분), `1h` (1시간) 또는 `1d` (1일).
+ `startDate` – Unix Epoch 시간(초)으로 표시되며 과거 데이터를 쿼리하기 시작할 범위의 시작(제외)입니다.
+ `endDate` – Unix Epoch 시간(초)으로 표시되며 과거 데이터를 쿼리하기 시작할 범위의 끝(포함)입니다.
다음 파라미터 중 하나를 전달하여 결과를 구체화할 수도 있습니다.
+ `maxResults` – 하나의 요청에서 반환할 최대 결과 수입니다. 기본값은 `20`개의 결과입니다.
+ `nextToken` – 이 작업의 이전 호출에서 반환된 페이지 매김 토큰입니다.
+ `timeOrdering` – 반환된 값에 적용할 정렬은 `ASCENDING` 또는 `DESCENDING` 입니다.
+ `qualities` – 결과 필터링 기준이 되는 품질은 `GOOD`, `BAD`, 또는 `UNCERTAIN`입니다.
**참고**
[GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html) 작업은 이 단원에서 설명하는 다른 작업과 다른 형식의 TQV를 반환합니다. `value` 구조에는 요청의 각 `aggregateTypes`에 대한 필드가 포함되어 있습니다. `timestamp`에는 집계가 발생한 Unix 에포크 시간(초)이 포함됩니다.
## 자산 속성에 대한 집계를 쿼리하려면(AWS CLI) 다음을 수행하세요.
**자산 속성에 대한 집계를 쿼리하려면(AWS CLI) 다음을 수행하세요.**
1. 다음 명령을 실행하여 자산 속성에 대한 집계를 가져옵니다. 이 명령은 특정한 1시간 간격에 대해 1시간 해상도로 평균과 합계를 쿼리합니다. *asset-id*를 자산의 ID로 바꾸고 *property-id*를 속성의 ID로 바꿉니다. 파라미터를 쿼리할 집계 및 간격으로 바꿉니다.
```
aws iotsitewise get-asset-property-aggregates \
--asset-id asset-id \
--property-id property-id \
--start-date 1575216000 \
--end-date 1575219600 \
--aggregate-types AVERAGE SUM \
--resolution 1h
```
이 작업은 다음 형식으로 속성의 과거 TQV를 포함하는 응답을 반환합니다. 응답에는 요청된 집계만 포함됩니다.
```
{
"aggregatedValues": [
{
"timestamp": Number,
"quality": "String",
"value": {
"average": Number,
"count": Number,
"maximum": Number,
"minimum": Number,
"standardDeviation": Number,
"sum": Number
}
}
],
"nextToken": "String"
}
```
1. 값 항목이 더 있는 경우 `nextToken` 필드의 페이지 매김 토큰을 [GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html)에 대한 후속 직접 호출에 전달할 수 있습니다.
**참고**
쿼리 범위에 `null` 값 TQVs. [AssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetPropertyValue.html) 개수를 제외한 모든 통계는 문자열 TQVs 대한 통계와 마찬가지로 `null` 응답을 생성합니다. 쿼리 범위에 이중 유형 TQVs에 `Double.NaN` 대한가 포함된 경우 개수를 제외한 모든 계산에서가 생성됩니다`Double.NaN`.