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

Tento článek shrnuje důležitost ID časové řady pro vaše prostředí Azure Time Series Přehledy Gen2 a osvědčené postupy pro výběr jednoho z nich.

Volba ID služby Time Series

Výběr vhodného ID časové řady je kritický. Volba ID časové řady je jako volba klíče oddílu pro databázi. Vyžaduje se při vytváření prostředí Azure Time Series Přehledy 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:

  • Řetězcová vlastnost s rozlišování malých a malých písmen: Velká a malá písmena se používají při vyhledávání, porovnávání, aktualizacích a při dělení.
  • Neměnná vlastnost: po vytvoření ji nelze změnit.

Tip

Pokud je zdrojem událostí centrum IoT, vaše ID časové řady bude pravděpodobně iothub-connection-device-id. Pokud plánujete používat modely IoT Plug and Play 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 byste ho v budoucnu potřebovali.

Mezi klíčové osvědčené postupy 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 vašem formátu JSON.
  • ID časové řady by mělo být jedinečné na úrovni uzlu list vašeho modelu Time Series .
  • Omezení počtu znaků pro řetězec názvu vlastnosti ID časové řady je 128. Pro hodnotu vlastnosti ID časové řady je limit znaků 1 024.
  • Pokud pro ID časové řady chybí jedinečná hodnota vlastnosti, je považována 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, při poskytování názvu vlastnosti dodržujte 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

    Vaše tři klíčové vlastnosti musí být řetězce. Na tento složený klíč byste se muset dotazovat, a ne na jednu vlastnost najednou.

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

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ší vozové parku prostředků. Každý z nich má jedinečný klíč.
  • Jeden vozový park je jednoznačně identifikován vlastností deviceId. U jiného vozového parku je jedinečná vlastnost objectId. Žádná z vozových parku neobsahuje jedinečnou vlastnost druhého vozového parku. V tomto příkladu byste jako jedinečné klíče vyberte dva klíče, deviceId a objectId.
  • Přijímáme hodnoty null a chybějící vlastnost v datové části události se počítá jako hodnota null. Je to také vhodný způsob, jak zpracovávat 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ženou klávesou

  • Vyžadujete, aby více vlastností bylo v rámci stejného vozového parku prostředků jedinečných.
  • Jste výrobcem inteligentních budov a nasazujete senzory do každé místnosti. V každé místnosti obvykle máte stejné hodnoty pro sensorId. Mezi příklady patří sensor1, sensor2 a sensor3.
  • Vaše budova se v lokalitách ve vlastnosti flrRm překrývají čísly podlah a místností. Tato čísla mají hodnoty jako 1a, 2b a 3a.
  • Máte vlastnost location (umístění), která obsahuje hodnoty, jako je Redmond , a Tokio. Pokud chcete vytvořit jedinečnost, určete následující tři vlastnosti jako klíče ID časové řady: sensorId, flrRm a location.

Příklad nezpracované události:

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

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

Nakonfigurujte ID časové řady pro prostředí.

Poznámka

V Azure Portal nezadáte do jednoho texboxu názvy vlastností oddělené čárkami, jinak se bude považovat za jeden název vlastnosti, který obsahuje čárky. Každý název vlastnosti zadejte do vlastního pole texbox.

Další kroky