View a markdown version of this page

Kueri agregat properti aset 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.

Kueri agregat properti aset 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 (rata-rata) nilai properti selama interval waktu.

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

  • maksimum — Maksimum nilai properti selama interval waktu.

  • minimum — Minimum nilai properti selama interval waktu.

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

  • sum — Jumlah nilai properti selama interval waktu.

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

Anda juga dapat menghitung metrik khusus 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)

Gunakan AWS IoT SiteWise API untuk mendapatkan agregat untuk properti aset.

Gunakan GetAssetPropertyAggregates operasi untuk menanyakan agregat properti aset.

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

  • Pro propertyId perti aset assetId dan properti tempat data dikirim.

  • 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 untuk menanyakan data historis, dinyatakan dalam detik dalam waktu zaman Unix.

  • endDate— Akhir inklusif dari rentang 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 20 hasil.

  • 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 berdasarkan: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 Ber timestamp isi waktu agregasi terjadi, dalam detik dalam waktu zaman 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. asset-idGanti 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 TQV historis properti dalam format berikut. Tanggapan 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 GetAssetPropertyAggregates operasi.

catatan

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