Agregat properti aset kueri - AWS IoT SiteWise
Agregat untuk properti aset () APIAgregat untuk properti aset ()AWS CLI

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Agregat properti aset kueri

AWS IoT SiteWise secara otomatis menghitung nilai properti aset agregat, yang merupakan seperangkat metrik dasar yang dihitung selama beberapa interval waktu. AWS IoT SiteWise menghitung agregat berikut setiap menit, jam, dan hari untuk properti aset Anda:

  • rata-rata — Rata-rata (mean) dari nilai properti selama interval waktu.

  • count — Jumlah titik data untuk properti selama interval waktu.

  • maksimum — Maksimum nilai properti selama interval waktu.

  • minimum — Minimal nilai properti selama interval waktu.

  • standar deviasi — Standar deviasi nilai properti selama interval waktu.

  • jumlah — Jumlah nilai properti selama interval waktu.

Untuk properti non-numerik, seperti string dan Boolean, hanya menghitung agregat AWS IoT SiteWise hitungan.

Anda juga dapat menghitung metrik kustom untuk data aset Anda. Dengan properti metrik, Anda menentukan agregasi yang spesifik untuk operasi Anda. Properti metrik menawarkan fungsi agregasi tambahan dan interval waktu yang tidak dihitung sebelumnya untuk. AWS IoT SiteWise API Untuk informasi selengkapnya, lihat Data agregat dari properti dan aset lainnya (metrik).

Agregat untuk properti aset () API

Anda dapat menggunakan AWS IoT SiteWise API untuk mendapatkan agregat untuk properti aset.

Gunakan GetAssetPropertyAggregatesoperasi untuk menanyakan agregat properti aset.

Untuk mengidentifikasi properti aset, tentukan salah satu dari berikut ini:

  • Properti propertyId aset yang dikirimkan ke data. assetId

  • ThepropertyAlias, yang merupakan alias aliran data (misalnya,/company/windfarm/3/turbine/7/temperature). Untuk menggunakan opsi ini, Anda harus terlebih dahulu menetapkan alias properti aset Anda. Untuk mengatur alias properti, lihatMemetakan aliran data industri ke properti aset.

Anda juga harus melewati parameter yang diperlukan berikut:

  • aggregateTypes— Daftar agregat untuk diambil. Anda dapat menentukan salah satu dariAVERAGE,COUNT,MAXIMUM,MINIMUM,STANDARD_DEVIATION, danSUM.

  • resolution— Interval waktu untuk mengambil metrik: 1m (1 menit), 1h (1 jam), atau 1d (1 hari).

  • startDate— Awal eksklusif dari rentang dari mana untuk menanyakan data historis, dinyatakan dalam detik dalam waktu zaman Unix.

  • endDate— Akhir inklusif dari rentang dari mana untuk menanyakan data historis, dinyatakan dalam detik dalam waktu zaman Unix.

Anda juga dapat meneruskan salah satu parameter berikut untuk menyempurnakan hasil Anda:

  • maxResults— Jumlah maksimum hasil untuk dikembalikan dalam satu permintaan. Default untuk hasil. 20

  • nextToken— Token pagination dikembalikan dari panggilan sebelumnya dari operasi ini.

  • timeOrdering— Urutan untuk diterapkan pada nilai yang dikembalikan: ASCENDING atauDESCENDING.

  • qualities— Kualitas untuk memfilter hasil dengan:GOOD,BAD, atauUNCERTAIN.

catatan

GetAssetPropertyAggregatesOperasi mengembalikan TQV dengan format yang berbeda dari operasi lain yang dijelaskan dalam bagian ini. valueStruktur berisi bidang untuk masing-masing permintaan. aggregateTypes timestampBerisi waktu agregasi terjadi, dalam detik dalam waktu epoch Unix.

Agregat untuk properti aset ()AWS CLI

Untuk menanyakan agregat untuk properti aset ()AWS CLI

  1. Jalankan perintah berikut untuk mendapatkan agregat untuk properti aset. Perintah ini menanyakan rata-rata dan jumlah dengan resolusi 1 jam untuk interval 1 jam tertentu. Ganti asset-id dengan ID aset dan property-id dengan ID properti. Ganti parameter dengan agregat dan interval untuk kueri.

    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

    Operasi mengembalikan respons yang berisi TQVs historis properti dalam format berikut. Respons hanya mencakup agregat yang diminta.

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

  2. Jika ada lebih banyak entri nilai, Anda dapat meneruskan token pagination dari nextToken bidang ke panggilan berikutnya ke operasi. GetAssetPropertyAggregates