Aanbevolen procedures voor het kiezen van een tijdreeks-id

Notitie

De Time Series Insights-service wordt op 7 juli 2024 buiten gebruik gesteld. Overweeg om bestaande omgevingen zo snel mogelijk naar alternatieve oplossingen te migreren. Bezoek onze documentatievoor meer informatie over de depreciatie en migratie.

Dit artikel bevat een overzicht van het belang van de Time Series-id voor uw Azure Time Series Insights Gen2-omgeving en aanbevolen procedures voor het kiezen van een omgeving.

Een tijdreeks-id kiezen

Het selecteren van een geschikte tijdreeks-id is essentieel. Het kiezen van een Tijdreeks-id is 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 omgevingen voor een gedetailleerde uitleg van de Time Series-id. U zult twee verschillende voorbeelden van JSON-telemetriepayloads en de juiste Time Series ID-selectie voor elk daarvan bekijken.

Belangrijk

Time Series-id's zijn:

• Een hoofdlettergevoelige tekenreeks eigenschap: letter- en karaktertekens worden gebruikt bij het zoeken, vergelijken, bijwerken, en bij het verdelen in delen.
• Een onveranderbare eigenschap: nadat deze is gemaakt, kan deze niet meer worden gewijzigd.

Fooi

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

Belangrijke aanbevolen procedures zijn onder andere:

• Kies een partitiesleutel met veel afzonderlijke waarden (bijvoorbeeld honderden of duizenden). In veel gevallen kan dit de apparaat-id, sensor-id of tag-id in uw JSON zijn.
• De tijdreeks-ID moet uniek zijn op het niveau van de eindknooppunten van uw tijdreeksmodel.
• De tekenlimiet voor de eigenschapsnaamtekenreeks 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 Time Series-id ontbreekt, wordt deze beschouwd als een null-waarde en volgt u dezelfde regel van de beperking voor uniekheid.
• Als uw Time Series ID is genest binnen een complex JSON-object, zorg er dan voor dat u de assetingangsregels voor flattening volgt bij het opgeven van de naam van uw eigenschap. Bekijk het voorbeeld B.
• U kunt ook tot drie sleuteleigenschappen selecteren als uw Time Series ID. Hun combinatie zal een samengestelde sleutel zijn die de tijdreeks-ID vertegenwoordigt.

  Notitie

  Uw drie sleuteleigenschappen moeten tekenreeksen zijn. U moet een query uitvoeren op deze samengestelde sleutel in plaats van afzonderlijke eigenschappen.

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: Tijdreeks-id met een unieke sleutel

• U hebt verouderde vloot van activa. Elk heeft een unieke sleutel.
• Eén vloot wordt uniek geïdentificeerd door de eigenschap deviceId. Voor een andere vloot is de unieke eigenschap objectId. Geen van beide vloten bevat de unieke eigenschap van de andere vloot. In dit voorbeeld selecteert u twee sleutels, deviceId en objectId, als unieke sleutels.
• We accepteren nulwaarden en het ontbreken van een eigenschap in de event payload wordt als een nulwaarde beschouwd. Dit is ook de juiste manier om het verzenden van gegevens naar twee gebeurtenisbronnen te verwerken, waarbij de gegevens in elke gebeurtenisbron een unieke Tijdreeks-id hebben.

Voorbeeld 2: Tijdreeks-ID met een samengestelde sleutel

• U wilt dat meerdere eigenschappen uniek zijn binnen dezelfde vloot van assets.
• 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, sensor2en sensor3.
• Uw gebouw heeft overlappende vloer- en kamernummers op locaties in de accommodatie flrRm. Deze getallen hebben waarden zoals 1a, 2ben 3a.
• U hebt een woning, locatie, met waarden zoals Redmond, Barcelonaen Tokyo. Als u uniek wilt zijn, wijst u de volgende drie eigenschappen aan als uw Tijdreeks-id-sleutels: sensorId, flrRmen locatie.

Voorbeeld van onbewerkte gebeurtenis:

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

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

Notitie

Voer in Azure Portal geen door komma's gescheiden namen van eigenschappen in één texbox in, anders wordt deze behandeld als één eigenschapsnaam die komma's bevat. Voer elke eigenschapsnaam in een eigen textbox in.

Volgende stappen

• Lees de JSON-afvlakken en escaperegels om te begrijpen hoe gebeurtenissen worden opgeslagen.

• Plan uw Azure Time Series Insights Gen2-omgeving.