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

Článek
06/13/2024

Poznámka:

Služba Time Series Insights bude vyřazena 7. července 2024. Zvažte migraci stávajících prostředí 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 vaše prostředí Azure Time Series Insights Gen2 a osvědčené postupy pro výběr z nich.

Volba ID služby Time Series

Výběr příslušného ID časové řady je kritický. Volba ID časové řady se podobá 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ždou z nich.

Důležité

ID časových řad jsou:

Vlastnost řetězce rozlišující velká a malá písmena: písmena a písmena se používají při hledání, porovnáních, aktualizacích a při dělení.
Neměnná vlastnost: Po vytvoření 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 modely zařízení technologie Plug and Play IoT nebo je používáte bez komponent, měli byste zahrnout dt-subject jako součást složeného klíče v případě, že ho budete potřebovat v budoucnu.

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

Vyberte klíč oddílu s mnoha různý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 formátu JSON.
ID časové řady by mělo být jedinečné na úrovni uzlu typu list modelu časové řady.
Limit znaků pro řetězec názvu vlastnosti ID časové řady je 128. Pro hodnotu vlastnosti ID časové řady je limit znaků 1 024.
Pokud chybí jedinečná hodnota vlastnosti ID časové řady, považuje se za hodnotu null a řídí se stejným pravidlem omezení jedinečnosti.
Pokud je ID časové řady vnořené do komplexního objektu JSON, nezapomeňte při zadávání názvu vlastnosti dodržovat pravidla zploště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 kombinace bude složený klíč, který představuje ID časové řady.

Poznámka:

Tři klíčové vlastnosti 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é klíčové vlastnosti jako ID časové řady.

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

Máte starší flotily prostředků. Každý z nich má jedinečný klíč.
Jedna flotila je jedinečně identifikována id zařízení vlastnosti. U jiného vozového parku je jedinečná vlastnost objectId. Žádná flotila neobsahuje jedinečnou vlastnost druhé flotily. V tomto příkladu byste jako jedinečné klíče vybrali dva klíče, deviceId a objectId.
Přijímáme hodnoty null a nedostatek přítomnosti vlastnosti v datové části události se počítá jako hodnota null. Je to také vhodný způsob, jak zpracovat 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 s složeným klíčem

Vyžadujete, aby více vlastností bylo jedinečné ve stejném portfoliu prostředků.
Jste výrobcem inteligentních budov a nasazujete senzory do všech místností. V každé místnosti obvykle máte stejné hodnoty pro sensorId. Příklady jsou senzor1, senzor2 a sensor3.
Vaše budova má překrývající se podlahu a čísla 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, označíte následující tři vlastnosti jako klíče ID časové řady: sensorId, flrRm a umístění.

Příklad nezpracované události:

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

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

Poznámka:

Na webu Azure Portal nezadávejte do jednoho texboxu názvy vlastností oddělené čárkami, jinak se bude považovat za jeden název vlastnosti, který obsahuje čárky. Zadejte název každé vlastnosti do vlastního texboxu.

Další kroky

Přečtěte si pravidla zploštění a eskapace JSON, abyste pochopili, jak budou události uloženy.
Naplánujte prostředí Azure Time Series Insights Gen2.

Sdílet prostřednictvím