에서 과거 자산 속성 값 쿼리 AWS IoT SiteWise - AWS IoT SiteWise

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

에서 과거 자산 속성 값 쿼리 AWS IoT SiteWise

AWS IoT SiteWise API GetAssetPropertyValueHistory 작업을 사용하여 자산 속성의 기록 값을 쿼리할 수 있습니다.

자산 속성을 식별하려면 다음 중 하나를 지정합니다.

  • 데이터를 보낼 자산 속성의 assetId 및 propertyId

  • 데이터 스트림 별칭(예: /company/windfarm/3/turbine/7/temperature)인 propertyAlias. 이 옵션을 사용하려면 먼저 자산 속성의 별칭을 설정해야 합니다. 속성 별칭을 설정하려면 에 대한 데이터 스트림 관리 AWS IoT SiteWise 섹션을 참조하세요.

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

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

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

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

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

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

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

자산 속성에 대한 값 기록을 쿼리하려면(AWS CLI) 다음을 수행하세요.

  1. 다음 명령을 실행하여 자산 속성에 대한 값 기록을 가져옵니다. 이 명령은 특정한 10분 간격 동안 속성의 기록을 쿼리합니다. asset-id를 자산의 ID로 바꾸고 property-id를 속성의 ID로 바꿉니다. 날짜 매개 변수를 쿼리할 간격으로 바꿉니다.

    aws iotsitewise get-asset-property-value-history \
  --asset-id asset-id \
  --property-id property-id \
  --start-date 1575216000 \
  --end-date 1575216600

    이 작업은 다음 형식으로 속성의 기록 TQV를 포함하는 응답을 반환합니다.

    {
  "assetPropertyValueHistory": [
    {
      "value": {
        "booleanValue": Boolean,
        "doubleValue": Number,
        "integerValue": Number,
        "stringValue": "String",
        "nullValue": {
            "valueType": "String"
        }
      },
      "timestamp": {
        "timeInSeconds": Number,
        "offsetInNanos": Number
      },
      "quality": "String"
    }
  ],
  "nextToken": "String"
}

  2. 값 항목이 더 있는 경우, nextToken 필드의 페이지 매김 토큰을 GetAssetPropertyValueHistory에 대한 후속 직접 호출에 전달할 수 있습니다.