집계 데이터 쿼리

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

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

AWS IoT 는 디바이스 플릿에서 집계 데이터를 검색할 수 있는 4개APIs(GetStatistics, GetCardinalityGetPercentiles, 및 GetBucketsAggregation)를 제공합니다.

GetStatistics

GetStatistics API 및 get-statistics CLI 명령은 지정된 집계 필드의 개수, 평균, 합계, 최소값, 최대값, 제곱 합계, 분산 및 표준 편차를 반환합니다.

get-statistics CLI 명령은 다음 파라미터를 사용합니다.

집계 필드의 유형은 반환된 통계에 영향을 줄 수 있습니다.

GetStatistics 문자열 값 사용

문자열 필드에서 집계하는 경우 GetStatistics를 호출하면 쿼리와 일치하는 속성이 있는 디바이스 수가 반환됩니다. 다음 예를 참조하세요.

aws iot get-statistics --aggregation-field 'attributes.stringAttribute'
            --query-string '*'

이 명령은 이름이 stringAttribute인 속성이 포함된 디바이스 수를 반환합니다.

{
  "statistics": {
    "count": 3
  }
}

GetStatistics 부울 값 사용

부울 집계 필드로 GetStatistics를 호출하는 경우:

GetStatistics 숫자 값 포함

GetStatistics를 호출하고 Number 유형의 집계 필드를 지정하면 GetStatistics에서 다음 값을 반환합니다.

다음 예제에서는 숫자 사용자 지정 필드로 get-statistics를 호출하는 방법을 보여줍니다.

aws iot get-statistics --aggregation-field 'attributes.numericAttribute2'
            --query-string '*'

{
  "statistics": {
    "count": 3,
    "average": 33.333333333333336,
    "sum": 100.0,
    "minimum": -125.0,
    "maximum": 150.0,
    "sumOfSquares": 43750.0,
    "variance": 13472.22222222222,
    "stdDeviation": 116.06990230986766
  }
}

숫자 집계 필드의 경우 필드 값이 최대 실수 값을 초과하면 통계 값이 비어 있습니다.

GetCardinality

GetCardinality API 및 get-cardinality CLI 명령은 쿼리와 일치하는 고유한 값의 대략적인 개수를 반환합니다. 예를 들어, 배터리 잔량이 50% 미만인 디바이스 수를 찾으려는 경우

aws iot get-cardinality --index-name AWS_Things --query-string "batterylevel
          > 50" --aggregation-field "shadow.reported.batterylevel"

이 명령은 배터리 잔량이 50% 이상인 사물 수를 반환합니다.

{
    "cardinality": 100
}

cardinality는 일치하는 필드가 없어도 항상 get-cardinality에 의해 반환됩니다. 예시:

aws iot get-cardinality --query-string "thingName:Non-existent*"
          --aggregation-field "attributes.customField_STR"

{
    "cardinality": 0
}

get-cardinality CLI 명령은 다음 파라미터를 사용합니다.

GetPercentiles

GetPercentiles API 및 get-percentiles CLI 명령은 쿼리와 일치하는 집계된 값을 백분위수 그룹으로 그룹화합니다. 기본 백분위수 그룹은 1, 5, 25, 50, 75, 95, 99입니다. 단, GetPercentiles를 호출할 때 직접 백분위수를 지정할 수 있습니다. 이 함수는 지정된 각 백분위수 그룹(또는 기본 백분위수 그룹)에 대한 값을 반환합니다. 백분위수 그룹 “1"에는 쿼리와 일치하는 값의 약 1%에서 발생하는 집계된 필드 값이 포함됩니다. 백분위수 그룹 “5"에는 쿼리와 일치하는 값의 약 5%에서 발생하는 집계된 필드 값이 포함됩니다. 결과는 근사치이며 쿼리와 일치하는 값이 많을수록 백분위수 값이 더 정확합니다.

다음 예제에서는 get-percentiles CLI 명령을 호출하는 방법을 보여줍니다.

aws iot get-percentiles --query-string "thingName:*" --aggregation-field
          "attributes.customField_NUM" --percents 10 20 30 40 50 60 70 80 90 99

{
    "percentiles": [
        {
            "value": 3.0,
            "percent": 80.0
        },
        {
            "value": 2.5999999999999996,
            "percent": 70.0
        },
        {
            "value": 3.0,
            "percent": 90.0
        },
        {
            "value": 2.0,
            "percent": 50.0
        },
        {
            "value": 2.0,
            "percent": 60.0
        },
        {
            "value": 1.0,
            "percent": 10.0
        },
        {
            "value": 2.0,
            "percent": 40.0
        },
        {
            "value": 1.0,
            "percent": 20.0
        },
        {
            "value": 1.4,
            "percent": 30.0
        },
        {
            "value": 3.0,
            "percent": 99.0
        }
    ]
}

다음 명령은 일치하는 문서가 없을 때 get-percentiles에서 반환된 출력을 보여줍니다.

aws iot get-percentiles --query-string "thingName:Non-existent*"
          --aggregation-field "attributes.customField_NUM"

{
    "percentiles": []
}

get-percentile CLI 명령은 다음 파라미터를 사용합니다.

GetBucketsAggregation

GetBucketsAggregation API 및 get-buckets-aggregation CLI 명령은 버킷 목록과 쿼리 문자열 기준에 맞는 총 사물 수를 반환합니다.

다음 예제에서는 CLI 명령을 호출 get-buckets-aggregation하는 방법을 보여줍니다.

aws iot get-buckets-aggregation --query-string '*' --index-name AWS_Things --aggregation-field 'shadow.reported.batterylevelpercent' --buckets-aggregation-type 'termsAggregation={maxBuckets=5}'

이 명령은 다음을 반환합니다.

{
    "totalCount": 20,
    "buckets": [
        {
            "keyValue": "100",
            "count": 12
        },
        {
            "keyValue": "90",
            "count": 5
        },
        {
            "keyValue": "75",
            "count": 3
        }
    ]
}

CLI 명령은 get-buckets-aggregation 다음 파라미터를 사용합니다.

권한 부여

다음과 같이 AWS IoT 정책 작업ARN에서 사물 그룹 인덱스를 리소스로 지정할 수 있습니다.