Praktik terbaik untuk memilih ID Seri Waktu

Artikel
06/01/2023

Catatan

Layanan Time Series Insights (TSI) tidak akan lagi didukung setelah Maret 2025. Pertimbangkan untuk memigrasikan lingkungan TSI yang ada ke solusi alternatif sesegera mungkin. Untuk informasi selengkapnya tentang penghentian dan migrasi, kunjungi dokumentasi kami.

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

Pilih ID Time Series

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

Tonton 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 contoh.

Penting

ID Time Series adalah:

Properti string peka huruf besar/kecil : huruf dan huruf digunakan dalam pencarian, perbandingan, pembaruan, dan saat partisi.
Properti tidak dapat diubah: setelah dibuat tidak dapat diubah.

Tip

Jika sumber kejadian Anda adalah hub IoT, ID Time Series Anda kemungkinan akan menjadi iothub-connection-device-id. Jika Anda berencana untuk menggunakan IoT Plug and Play model perangkat 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 dapat berupa ID perangkat, ID sensor, atau ID tag di JSON Anda.
ID Time Series harus unik di tingkat simpul daun Model Time Series Anda.
Batas karakter untuk untai nama properti ID Time Series adalah 128. Untuk nilai properti ID Time Series, batasnya karakter adalah 1.024.
Jika nilai properti unik untuk ID Time Series tidak tersedia, id properti tersebut diperlakukan sebagai nilai kosong dan mengikuti aturan yang sama dari batasan keunikan.
Jika ID Time Series Anda dilapiskan dalam objek JSON yang kompleks, pastikan untuk mengikuti aturan perataan penyerapan saat memberikan nama properti Anda. Lihat contoh B.
Anda juga dapat memilih hingga tiga properti utama sebagai ID Time Series Anda. Kombinasinya akan menjadi kunci komposit yang mewakili ID Time Series.

Catatan

Tiga properti utama Anda harus berupa untai. Anda harus mengkueri terhadap kunci komposit ini, bukan satu properti pada satu waktu.

Memilih lebih dari satu properti kunci

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

Contoh 1: ID Time Series dengan kunci unik

Anda memiliki armada aset warisan. Masing-masing memiliki kunci yang unik.
Satu armada secara unik diidentifikasi oleh properti deviceId. Untuk armada lain, properti uniknya adalah objectId. Tidak ada armada yang berisi properti unik armada lainnya. Dalam contoh ini, Anda akan memilih dua kunci yaitu deviceId dan objectId, sebagai kunci unik.
Kita menerima nilai kosong, dan kurang tersedianya properti dalam payload kejadian dihitung sebagai nilai kosong. Ini juga merupakan cara yang tepat untuk menangani pengiriman data ke dua sumber kejadian, di mana data di setiap sumber kejadian memiliki ID Time Series yang unik.

Contoh 2: ID Time Series dengan kunci komposit

Anda memerlukan beberapa properti agar 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 sensor1, sensor2, dan sensor3.
Bangunan Anda memiliki nomor lantai dan kamar yang tumpang tindih di seluruh situs di flrRm properti. Nomor-nomor ini memiliki nilai seperti 1a, 2b, dan 3a.
Anda memiliki properti, lokasi, yang berisi nilai-nilai seperti Redmond, Barcelona, dan Tokyo. Agar unik, Anda menunjuk tiga properti berikut sebagai kunci ID Time Series Anda: sensorId, flrRm, dan lokasi.

Contoh kejadian mentah:

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

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