Bagikan melalui

Praktik terbaik untuk memilih ID Time Series

  • Artikel

Nota

Layanan Time Series Insights akan dihentikan pada 7 Juli 2024. Pertimbangkan untuk memigrasikan lingkungan yang ada ke solusi alternatif sesegera mungkin. Untuk informasi selengkapnya tentang penghentian dan migrasi, kunjungi dokumentasi kami.

Artikel ini merangkum pentingnya ID Time Series untuk lingkungan Azure Time Series Insights Gen2 Anda, dan praktik terbaik untuk memilihnya.

Pilih ID Rangkaian Waktu

Memilih ID Time Series yang sesuai sangat penting. Memilih ID Time Series seperti memilih kunci partisi untuk database. Ini diperlukan saat Anda membuat lingkungan Azure Time Series Insights Gen2.

Lihat tutorial penyediaan lingkungan untuk penjelasan terperinci tentang ID Time Series. Anda akan melihat dua contoh payload telemetri JSON yang berbeda dan pilihan ID Time Series yang benar untuk masing-masing.

Penting

ID Time Series adalah:

  • String dengan sensitivitas terhadap ukuran huruf properti: huruf dan ukuran karakter digunakan dalam pencarian, perbandingan, pembaruan, dan saat mempartisi.
  • Properti yang tidak dapat diubah : setelah dibuat, properti tidak dapat diubah.

Tips

Jika sumber peristiwa Anda adalah hub IoT, ID Time Series Anda kemungkinan akan iothub-connection-device-id. Jika Anda berencana untuk menggunakan model perangkat IoT Plug and Play atau menggunakannya tanpa komponen, Anda harus menyertakan dt-subject sebagai bagian dari kunci komposit jika Anda membutuhkannya di masa mendatang.

Praktik terbaik utama yang harus diikuti meliputi:

  • Pilih kunci partisi dengan banyak nilai berbeda (misalnya, ratusan atau ribuan). Dalam banyak kasus, ini mungkin ID perangkat, ID sensor, atau ID tag di JSON Anda.
  • ID Time Series harus unik pada tingkat node daun Model Time Series Anda.
  • Batas karakter untuk string nama properti ID Time Series adalah 128. Untuk nilai properti ID Time Series, batas karakter adalah 1.024.
  • Jika nilai properti unik untuk ID Time Series hilang, nilai tersebut diperlakukan sebagai nilai null dan mengikuti aturan batasan keunikan yang sama.
  • Jika ID Time Series Anda ditumpuk dalam objek JSON yang kompleks, pastikan untuk mengikuti aturan masuk meratakan saat memberikan nama properti Anda. Lihat contoh B.
  • Anda juga dapat memilih hingga tiga properti kunci sebagai ID Time Series Anda. Kombinasinya akan menjadi kunci komposit yang mewakili ID Time Series.

    Nota

    Tiga properti utama Anda harus berupa string. Anda harus melakukan kueri terhadap kunci komposit ini daripada satu properti pada satu waktu.

Pilih lebih dari satu properti kunci

Skenario berikut menjelaskan memilih lebih dari satu properti kunci sebagai ID Time Series Anda.

Contoh 1: ID Time Series dengan kunci unik

  • Anda memiliki armada aset warisan. Masing-masing memiliki kunci unik.
  • Satu armada diidentifikasi secara unik oleh properti deviceId. Untuk armada lain, properti unik adalah objectId. Tidak ada armada yang memiliki properti unik dari armada lainnya. Dalam contoh ini, Anda akan memilih dua kunci, deviceId dan objectId, sebagai kunci unik.
  • Kami menerima nilai null, dan ketiadaan properti dalam payload peristiwa dianggap sebagai nilai null. Ini juga merupakan cara yang tepat untuk menangani pengiriman data ke dua sumber peristiwa di mana data di setiap sumber peristiwa memiliki ID Time Series yang unik.

Contoh 2: ID Rangkaian Waktu dengan kunci komposit

  • Anda memerlukan beberapa properti untuk unik dalam armada aset yang sama.
  • Anda adalah produsen bangunan pintar dan menyebarkan sensor di setiap ruangan. Di setiap ruangan, Anda biasanya memiliki nilai yang sama untuk *sensorId* . Contohnya adalah sensor 1, sensor 2, dan sensor 3.
  • Bangunan Anda memiliki lantai dan nomor kamar yang tumpang tindih di seluruh situs di properti flrRm. Angka-angka ini memiliki nilai seperti 1a, 2b, dan 3a.
  • Anda memiliki properti, lokasi , yang berisi nilai seperti Redmond, Barcelona, dan Tokyo. Untuk membuat keunikan, Anda menunjuk tiga properti berikut sebagai kunci ID Time Series Anda: sensorId, flrRm, dan lokasi .

Contoh peristiwa mentah:

{
  "sensorId": "sensor1",
  "flrRm": "1a",
  "location": "Redmond",
  "temperature": 78
}

Di portal Microsoft Azure, Anda kemudian dapat memasukkan kunci komposit sebagai berikut:

Mengonfigurasi ID Time Series untuk lingkungan.

Nota

Di portal Microsoft Azure, jangan masukkan nama properti yang dipisahkan koma dalam satu kotak texbox, jika tidak, properti tersebut akan diperlakukan sebagai satu nama properti yang berisi koma. Masukkan setiap nama properti di kotak texnya sendiri.

Langkah berikutnya