Osvědčené postupy při výběru ID časové řady

Článek
06/01/2023

Poznámka

Služba Time Series Insights (TSI) už nebude po březnu 2025 podporována. Zvažte migraci stávajících prostředí TSI na alternativní řešení co nejdříve. Další informace o vyřazení a migraci najdete v naší dokumentaci.

Tento článek shrnuje důležitost ID časové řady pro prostředí Azure Time Series Insights Gen2 a osvědčené postupy pro jeho výběr.

Volba ID služby Time Series

Výběr příslušného ID časové řady je velmi důležitý. Volba ID časové řady je podobná výběru klíče oddílu pro databázi. Vyžaduje se při vytváření prostředí Azure Time Series Insights Gen2.

Podrobné vysvětlení ID časové řady najdete v kurzu zřizování prostředí. Zobrazí se dva různé příklady datové části telemetrie JSON a správný výběr ID časové řady pro každý z nich.

Důležité

ID časových řad jsou:

Vlastnost řetězce rozlišující malá a velká písmena: písmena a písmena se používají při hledání, porovnávání, aktualizacích a při dělení na oddíly.
Neměnná vlastnost: Po vytvoření ji nelze změnit.

Tip

Pokud je zdrojem událostí centrum IoT, id časové řady bude pravděpodobně iothub-connection-device-id. Pokud plánujete používat IoT Plug and Play modely zařízení nebo je používáte bez komponent, měli byste jako součást složeného klíče zahrnout dt-subject pro případ, že ho budete v budoucnu potřebovat.

Mezi klíčové osvědčené postupy, které je třeba dodržovat, patří:

Vyberte klíč oddílu s mnoha jedinečnými hodnotami (například stovky nebo tisíce). V mnoha případech to může být ID zařízení, ID senzoru nebo ID značky ve vašem KÓDU JSON.
ID časové řady by mělo být jedinečné na úrovni uzlu listu modelu časové řady.
Limit počtu znaků pro řetězec názvu vlastnosti ID časové řady je 128. Pro hodnotu vlastnosti ID časové řady je limit počtu znaků 1 024.
Pokud pro ID časové řady chybí jedinečná hodnota vlastnosti, považuje se za hodnotu null a řídí se stejným pravidlem omezení jedinečnosti.
Pokud je vaše ID časové řady vnořené do složitého objektu JSON, nezapomeňte při zadávání názvu vlastnosti dodržovat pravidla zplošťování příchozího přenosu dat. Podívejte se na příklad B.
Jako ID časové řady můžete také vybrat až tři klíčové vlastnosti. Jejich kombinací bude složený klíč, který představuje ID časové řady.

Poznámka

Tři vlastnosti klíče musí být řetězce. Místo jedné vlastnosti byste museli dotazovat na tento složený klíč.

Výběr více než jedné vlastnosti klíče

Následující scénáře popisují výběr více než jedné vlastnosti klíče jako ID časové řady.

Příklad 1: ID časové řady s jedinečným klíčem

Máte starší flotily prostředků. Každý má jedinečný klíč.
Jeden vozový park je jedinečně identifikovaný podle vlastnosti deviceId. U jiného vozového parku je jedinečná vlastnost objectId. Ani jedno z nich neobsahuje jedinečnou vlastnost druhého vozového parku. V tomto příkladu byste vybrali dva klíče , deviceId a objectId, jako jedinečné klíče.
Přijímáme hodnoty null a chybějící přítomnost vlastnosti v datové části události se počítá jako hodnota null. Je to také vhodný způsob zpracování odesílání dat do dvou zdrojů událostí, kde data v každém zdroji událostí mají jedinečné ID časové řady.

Příklad 2: ID časové řady se složeným klíčem

Vyžadujete, aby v rámci stejné flotily prostředků bylo jedinečných více vlastností.
Jste výrobce inteligentních budov a nasazujete senzory v každé místnosti. V každé místnosti máte obvykle stejné hodnoty pro sensorId. Příklady jsou sensor1, sensor2 a sensor3.
Vaše budova má překrývající se čísla podlah a místností napříč weby v objektu flrRm. Tato čísla mají hodnoty jako 1a, 2b a 3a.
Máte vlastnost , umístění, která obsahuje hodnoty, jako jsou Redmond, Barcelona a Tokio. Pokud chcete vytvořit jedinečnost, určíte jako klíče ID časové řady následující tři vlastnosti: sensorId, flrRm a location.

Příklad nezpracované události:

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

V Azure Portal pak můžete zadat složený klíč následujícím způsobem: