過去のアセットプロパティ値をクエリする - AWS IoT SiteWise

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

過去のアセットプロパティ値をクエリする

GetAssetPropertyValueHistory オペレーションを使用して AWS IoT SiteWise API、アセットプロパティの履歴値をクエリできます。

アセットプロパティを識別するには、次のいずれかを指定します。

  • データが送信されるアセットプロパティpropertyIdの assetIdと 。

  • データストリームのエイリアスである propertyAlias (例えば、/company/windfarm/3/turbine/7/temperature)。このオプションを使用するには、最初にアセットプロパティのエイリアスを設定する必要があります。プロパティエイリアスを設定するには、「」を参照してください産業データストリームをアセットプロパティにマッピングする。

次のパラメータを渡して結果を絞り込みます。

  • startDate - 履歴データをクエリる範囲の開始点を (Unix エポックタイムで秒単位)。

  • endDate - 履歴データをクエリする範囲の終端を (Unix エポックタイムで秒単位)。

  • maxResults - 1 回のリクエストで返す結果の最大数。デフォルトは 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

    オペレーションは、 プロパティTQVsの履歴を含むレスポンスを次の形式で返します。

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

  2. より多くの値エントリが存在する場合は、ページ割りトークンを nextTokenフィールドから GetAssetPropertyValueHistoryオペレーションへの後続の呼び出しに渡すことができます。