Agregat properti aset kueri di AWS IoT SiteWise - AWS IoT SiteWise
Agregat untuk properti aset (API)Agregat 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 di AWS IoT SiteWise

AWS IoT SiteWise secara otomatis menghitung nilai properti aset agregat, yang merupakan sekumpulan 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 API. AWS IoT SiteWise Untuk informasi selengkapnya, lihat Data agregat dari properti dan aset lainnya (metrik).

Agregat untuk properti aset (API)

Gunakan 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, lihatMengelola aliran data untuk AWS IoT SiteWise.

Anda 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), 15m (15 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 respon 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, teruskan token pagination dari nextToken bidang ke panggilan berikutnya ke operasi. GetAssetPropertyAggregates

catatan

Jika rentang kueri berisi null nilai TQVs, lihat AssetPropertyValueAPI. Semua statistik kecuali hitungan, menghasilkan null respons, mirip dengan statistik untuk String TQVs. Jika rentang kueri Anda berisi Double.NaN tipe ganda TQVs, semua perhitungan kecuali hitungan akan menghasilkan aDouble.NaN.