Az idősor-azonosító kiválasztásának ajánlott eljárásai
Megjegyzés
A Time Series Insights (TSI) szolgáltatás 2025 márciusa után már nem támogatott. Fontolja meg a meglévő TSI-környezetek migrálását alternatív megoldásokba a lehető leghamarabb. Az elavulással és a migrálással kapcsolatos további információkért tekintse meg dokumentációnkat.
Ez a cikk a Azure Time Series Insights Gen2-környezet idősor-azonosítójának fontosságát és az egyik kiválasztásának ajánlott eljárásait foglalja össze.
Time Series-azonosító kiválasztása
A megfelelő idősor-azonosító kiválasztása kritikus fontosságú. Az idősor-azonosító kiválasztása olyan, mintha partíciókulcsot választanál egy adatbázishoz. Ez Azure Time Series Insights Gen2-környezet létrehozásakor szükséges.
Tekintse meg a környezetkiépítési oktatóanyagot az idősor-azonosító részletes magyarázatáért. Két különböző JSON-telemetria hasznosadat-példát és a megfelelő idősor-azonosítót fogja látni mindegyikhez.
Fontos
Az idősorozat-azonosítók a következők:
- Kis- és nagybetűket megkülönböztető karakterlánc-tulajdonság: a betű- és karakterházat a keresések, az összehasonlítások, a frissítések és a particionálás során használják.
- Nem módosítható tulajdonság: a létrehozás után nem módosítható.
Tipp
Ha az eseményforrás egy IoT Hub, akkor az idősor azonosítója valószínűleg iothub-connection-device-id lesz. Ha IoT-Plug and Play eszközmodelleket szeretne használni, vagy összetevők nélkül használja őket, akkor a dt-subject értéket is bele kell foglalnia az összetett kulcsba, ha a jövőben szüksége lesz rá.
A következő ajánlott eljárások a következők:
- Válasszon egy partíciókulcsot, amely számos különböző értékkel rendelkezik (például több száz vagy ezres). Sok esetben ez lehet a JSON eszközazonosítója, érzékelőazonosítója vagy címkeazonosítója.
- Az idősor-azonosítónak egyedinek kell lennie az idősormodell levélcsomópont-szintjén.
- Az idősor-azonosító tulajdonságnév-sztringjének karakterkorlátja 128. Az idősor-azonosító tulajdonságértékéhez a karakterkorlát 1024.
- Ha hiányzik az idősor-azonosító egyedi tulajdonságértéke, a rendszer null értékként kezeli, és az egyediségi kényszer ugyanazon szabályát követi.
- Ha az idősor-azonosító egy összetett JSON-objektumba van ágyazva, mindenképpen kövesse a bemeneti simítási szabályokat a tulajdonságnév megadásakor. Tekintse meg a B példát.
- Idősor-azonosítóként akár három kulcstulajdonság is kiválasztható. Ezek kombinációja egy összetett kulcs lesz, amely az idősor-azonosítót jelöli.
Megjegyzés
A három kulcstulajdonságnak sztringeknek kell lennie. Egyszerre egy tulajdonság helyett ezt az összetett kulcsot kell lekérdeznie.
Több kulcstulajdonság kijelölése
Az alábbi forgatókönyvek egynél több kulcstulajdonság idősor-azonosítóként való kiválasztását írják le.
1. példa: Idősor azonosítója egyedi kulccsal
- Örökölt eszközflottái vannak. Mindegyik egyedi kulccsal rendelkezik.
- Az egyik flottát egyedileg azonosítja a deviceId tulajdonság. Egy másik flotta esetében az egyedi tulajdonság az objectId. Egyik flotta sem tartalmazza a másik flotta egyedi tulajdonát. Ebben a példában két kulcsot, a deviceId és az objectId azonosítót választaná egyedi kulcsként.
- Null értékeket fogadunk el, és a tulajdonság jelenlétének hiánya az esemény hasznos adataiban null értékűnek számít. Ez a megfelelő módszer arra is, hogy adatokat küldjön két eseményforrásnak, ahol az egyes eseményforrások adatai egyedi idősor-azonosítóval rendelkeznek.
2. példa: Idősor azonosítója összetett kulccsal
- Több tulajdonságnak kell egyedinek lennie ugyanazon az eszközflottán belül.
- Ön intelligens épületek gyártója, és érzékelőket helyez üzembe minden helyiségben. Az egyes helyiségekben általában ugyanazokat az értékeket használja a sensorId értékhez. Ilyen például az érzékelő1, az érzékelő2 és az érzékelő3.
- Az épület emeleti és helyiségszámai átfedésben vannak az flrRm tulajdonság különböző helyszínein. Ezek a számok olyan értékekkel rendelkeznek, mint az 1a, a 2b és a 3a.
- Van egy tulajdonsága, a helye, amely olyan értékeket tartalmaz, mint Redmond, Barcelona és Tokió. Az egyediség létrehozásához a következő három tulajdonságot kell megadnia idősorozat-azonosító kulcsként: sensorId, flrRm és location.
Példa nyers eseményre:
{
"sensorId": "sensor1",
"flrRm": "1a",
"location": "Redmond",
"temperature": 78
}
A Azure Portal ezután a következőképpen adhatja meg az összetett kulcsot:
Megjegyzés
A Azure Portal ne adjon meg vesszővel tagolt tulajdonságokat egy texboxban, ellenkező esetben a rendszer egyetlen tulajdonságnévként kezeli, amely vesszőket tartalmaz. Adja meg az egyes tulajdonságneveket a saját texboxjában.
Következő lépések
Az események tárolásának megértéséhez olvassa el a JSON simítási és menekülési szabályait .
Tervezze meg a Azure Time Series Insights Gen2-környezetet.