Best practices voor het kiezen van een tijdreeks-id

Artikel
06/01/2023

Notitie

De TSI-service (Time Series Insights) wordt na maart 2025 niet meer ondersteund. Overweeg om bestaande TSI-omgevingen zo snel mogelijk te migreren naar alternatieve oplossingen. Raadpleeg onze documentatie voor meer informatie over de afschaffing en migratie.

In dit artikel vindt u een overzicht van het belang van de tijdreeks-id voor uw Azure Time Series Insights Gen2-omgeving en de aanbevolen procedures voor het kiezen van een id.

Een Time Series-id kiezen

Het selecteren van een juiste Time Series-id is essentieel. Het kiezen van een Time Series-id is net als het kiezen van een partitiesleutel voor een database. Dit is vereist wanneer u een Azure Time Series Insights Gen2-omgeving maakt.

Bekijk de zelfstudie over het inrichten van de omgeving voor een gedetailleerde uitleg van de Time Series-id. U ziet twee voorbeelden van JSON-telemetriepayloads en de juiste tijdreeks-id-selectie voor elk.

Belangrijk

Time Series-id's zijn:

Een hoofdlettergevoelige tekenreekseigenschap : letter- en tekenletters worden gebruikt in zoekopdrachten, vergelijkingen, updates en bij partitionering.
Een onveranderbare eigenschap: nadat deze is gemaakt, kan deze niet meer worden gewijzigd.

Tip

Als uw gebeurtenisbron een IoT-hub is, is uw Time Series-id waarschijnlijk iothub-connection-device-id. Als u van plan bent om IoT Plug en Play apparaatmodellen te gebruiken of als u ze zonder onderdelen gebruikt, moet u dt-subject opnemen als onderdeel van de samengestelde sleutel voor het geval u dit in de toekomst nodig hebt.

De belangrijkste aanbevolen procedures die u moet volgen, zijn onder andere:

Kies een partitiesleutel met veel verschillende waarden (bijvoorbeeld honderden of duizenden). In veel gevallen kan dit de apparaat-id, sensor-id of tag-id in uw JSON zijn.
De Time Series-id moet uniek zijn op het niveau van het leaf-knooppunt van uw Time Series-model.
De tekenlimiet voor de tekenreeks van de eigenschapsnaam van de Time Series-id is 128. Voor de eigenschapswaarde van de Time Series-id is de tekenlimiet 1024.
Als een unieke eigenschapswaarde voor de tijdreeks-id ontbreekt, wordt deze behandeld als een null-waarde en volgt deze dezelfde regel van de beperking voor uniekheid.
Als uw Time Series-id is genest in een complex JSON-object, moet u de regels voor het afvlakken van inkomend verkeer volgen bij het opgeven van de eigenschapsnaam. Bekijk voorbeeld B.
U kunt ook maximaal drie sleuteleigenschappen selecteren als tijdreeks-id. Hun combinatie is een samengestelde sleutel die de tijdreeks-id vertegenwoordigt.

Notitie

Uw drie sleuteleigenschappen moeten tekenreeksen zijn. U moet een query uitvoeren op deze samengestelde sleutel in plaats van één eigenschap tegelijk.

Meer dan één sleuteleigenschap selecteren

In de volgende scenario's wordt beschreven hoe u meer dan één sleuteleigenschap selecteert als uw Time Series-id.

Voorbeeld 1: Time Series-id met een unieke sleutel

U hebt verouderde assets. Elk heeft een unieke sleutel.
Eén vloot wordt uniek geïdentificeerd door de eigenschap deviceId. Voor een ander wagenpark is de unieke eigenschap objectId. Geen van beide vloot bevat het unieke eigendom van de andere vloot. In dit voorbeeld selecteert u twee sleutels, deviceId en objectId, als unieke sleutels.
We accepteren null-waarden en het ontbreken van de aanwezigheid van een eigenschap in de nettolading van de gebeurtenis telt als een null-waarde. Dit is ook de juiste manier om het verzenden van gegevens naar twee gebeurtenisbronnen af te handelen, waarbij de gegevens in elke gebeurtenisbron een unieke tijdreeks-id hebben.

Voorbeeld 2: Time Series-id met een samengestelde sleutel

U wilt dat meerdere eigenschappen uniek zijn binnen dezelfde activavloot.
U bent een fabrikant van slimme gebouwen en implementeert sensoren in elke ruimte. In elke ruimte hebt u doorgaans dezelfde waarden voor sensorId. Voorbeelden zijn sensor1, sensor2 en sensor3.
Uw gebouw heeft overlappende vloer- en kamernummers op sites in de flrRm van de accommodatie. Deze getallen hebben waarden zoals 1a, 2b en 3a.
U hebt een eigenschap, locatie, die waarden bevat, zoals Redmond, Barcelona en Tokio. Als u uniek wilt zijn, wijst u de volgende drie eigenschappen aan als uw Time Series-id-sleutels: sensorId, flrRm en location.

Voorbeeld van onbewerkte gebeurtenis:

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

In de Azure Portal kunt u de samengestelde sleutel als volgt invoeren: