자산 속성 집계를 쿼리합니다. - AWS IoT SiteWise
자산 자산의 집계 () API자산 자산의 집계 ()AWS CLI

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

자산 속성 집계를 쿼리합니다.

AWS IoT SiteWise 여러 시간 간격으로 계산된 기본 지표 집합인 집계된 자산 속성 값을 자동으로 계산합니다. AWS IoT SiteWise 자산 속성에 대해 분, 시간, 일마다 다음과 같은 집계를 계산합니다.

  • average(평균) – 시간 간격 동안 속성 값의 평균입니다.

  • count(개수) – 일정 기간에 걸친 속성의 데이터 포인트 수입니다.

  • maximum(최대) – 시간 간격 동안 속성 값의 최대값입니다.

  • minimum(최소) – 시간 간격 동안 속성 값의 최소값입니다.

  • standard deviation(표준 편차) – 시간 간격 동안 속성 값의 표준 편차입니다.

  • sum(합계) – 시간 간격 동안 속성 값의 합계입니다.

문자열이나 불리언과 같은 숫자가 아닌 속성의 경우 집계된 개수만 계산합니다. AWS IoT SiteWise

자산 데이터에 대한 사용자 지정 지표를 계산할 수도 있습니다. 지표 속성을 사용하면 작업별 집계를 정의할 수 있습니다. 지표 속성은 에 대해 미리 계산되지 않은 추가 집계 함수와 시간 간격을 제공합니다. AWS IoT SiteWise API 자세한 내용은 속성 및 기타 자산 (지표) 의 데이터를 집계합니다. 단원을 참조하십시오.

자산 속성의 집계 () API

를 사용하여 자산 AWS IoT SiteWise API 속성에 대한 집계를 가져올 수 있습니다.

GetAssetPropertyAggregates작업을 사용하여 자산 속성의 집계를 쿼리할 수 있습니다.

자산 속성을 식별하려면 다음 중 하나를 지정하십시오.

  • 데이터가 전송되는 자산 propertyId 자산의 소유자. assetId

  • 데이터 스트림 별칭(예: /company/windfarm/3/turbine/7/temperature)인 propertyAlias. 이 옵션을 사용하려면 먼저 자산 속성의 별칭을 설정해야 합니다. 속성 별칭을 설정하려면 을 참조하십시오산업 데이터 스트림을 자산 속성에 매핑.

또한 다음과 같은 필수 파라미터를 전달해야 합니다.

  • aggregateTypes – 검색할 집계 목록입니다. AVERAGE, COUNT, MAXIMUM, MINIMUM, STANDARD_DEVIATION, SUM 중 하나를 지정할 수 있습니다.

  • resolution – 1m (1분), 1h (1시간) 또는 1d (1일) 등 지표를 검색할 시간 간격입니다.

  • startDate – Unix Epoch 시간(초)으로 표시되며 과거 데이터를 쿼리하기 시작할 범위의 시작(제외)입니다.

  • endDate – Unix Epoch 시간(초)으로 표시되며 과거 데이터를 쿼리하기 시작할 범위의 끝(포함)입니다.

다음 파라미터 중 하나를 전달하여 결과를 구체화할 수도 있습니다.

  • maxResults – 하나의 요청에서 반환할 최대 결과 수입니다. 기본값은 20개의 결과입니다.

  • nextToken – 이 작업의 이전 호출에서 반환된 페이지 매김 토큰입니다.

  • timeOrdering – 반환된 값에 적용할 정렬은 ASCENDING 또는 DESCENDING 입니다.

  • qualities – 결과 필터링 기준이 되는 품질은 GOOD, BAD, 또는 UNCERTAIN입니다.

참고

이 GetAssetPropertyAggregates작업은 이 섹션에 설명된 다른 TQV 작업과 다른 형식의 a를 반환합니다. value 구조에는 요청의 각 aggregateTypes에 대한 필드가 포함되어 있습니다. timestamp에는 집계가 발생한 Unix 에포크 시간(초)이 포함됩니다.

자산 속성에 대한 집계 ()AWS CLI

자산 속성에 대한 집계를 쿼리하려면 ()AWS CLI

  1. 다음 명령을 실행하여 자산 속성에 대한 집계를 가져옵니다. 이 명령은 특정한 1시간 간격에 대해 1시간 해상도로 평균과 합계를 쿼리합니다. Replace 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

    이 작업은 속성의 내역을 TQVs 다음 형식으로 포함하는 응답을 반환합니다. 응답에는 요청된 집계만 포함됩니다.

    {
  "aggregatedValues": [
    {
      "timestamp": Number,
      "quality": "String",
      "value": {
        "average": Number,
        "count": Number,
        "maximum": Number,
        "minimum": Number,
        "standardDeviation": Number,
        "sum": Number
      }
    }
  ],
  "nextToken": "String"
}

  2. 값 항목이 더 있는 경우 nextToken 필드의 페이지 매김 토큰을 후속 GetAssetPropertyAggregates작업 호출에 전달할 수 있습니다.