Ajánlott eljárások idősor-azonosító kiválasztásához
Jegyzet
A Time Series Insights szolgáltatás 2024. július 7-én megszűnik. Fontolja meg a meglévő 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 az Azure Time Series Insights Gen2-környezet idősorozat-azonosítójának fontosságát és az egyik kiválasztásának ajánlott eljárásait foglalja össze.
Idősor-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 egy partíciókulcsot választanál egy adatbázishoz. Ez az Azure Time Series Insights Gen2-környezet létrehozásakor szükséges.
Tekintse meg a környezet előkészítési oktatóanyagot az idősorok azonosítójának részletes magyarázatáért. Két különböző JSON-telemetria hasznos adatra vonatkozó példát és a megfelelő idősor-azonosítót fogja látni mindegyikhez.
Fontos
Az idősorozat azonosítói a következők:
- A kis- és nagybetűket megkülönböztető sztring tulajdonság: a betű- és karakterházat a keresésekben, összehasonlításokban, frissítésekben és particionáláskor használják.
- Egy nem módosítható tulajdonság: a létrehozás után nem módosítható.
Borravaló
Ha az eseményforrás egy IoT Hub, akkor az idősor azonosítója valószínűleg iothub-connection-device-idlesz. Ha IoT Plug and Play-eszközmodelleket szeretne használni, vagy összetevők nélkül használja őket, az összetett kulcs részeként dt-subject kell tartalmaznia, ha a jövőben szüksége lesz rá.
A követendő legjobb gyakorlatok a következők:
- Válasszon egy partíciókulcsot több különböző értékkel (például több száz vagy ezres értékekkel). Sok esetben ez lehet az eszközazonosító, az érzékelő azonosítója vagy a címkeazonosító a JSON-ban.
- Az idősorazonosítónak egyedinek kell lennie a idősormodelllevélcsomópont szintjén.
- A Time Series ID tulajdonságnevének karakterkorlátja 128. Az idősor-azonosító tulajdonságértékéhez a karakterkorlát 1024.
- Ha hiányzik egy egyedi tulajdonságérték az idősor-azonosítóhoz, akkor null értékűként lesz kezelve, és az egyediségi korlátozás ugyanazon szabályát követi.
- Ha az idősor azonosítója egy összetett JSON-objektumba van ágyazva, ügyeljen arra, hogy a tulajdonságnév megadásakor kövesse a bemeneti simító szabályokat. Nézd meg a példát.
- Az idősor azonosítójaként legfeljebb három kulcstulajdonság közül választhat
. A kombináció egy összetett kulcs lesz, amely az idősor azonosítóját jelöli. Jegyzet
A három kulcstulajdonságnak karakterláncoknak kell lennie. Ehhez az összetett kulcshoz kell lekérdeznie, ahelyett hogy egy-egy tulajdonságot külön-külön kérdezne le.
Több kulcstulajdonság kijelölése
Az alábbi forgatókönyvek egynél több kulcstulajdonságot jelölnek ki idősor-azonosítóként.
1. példa: Idősor azonosítója egyedi kulccsal
- Régi eszközparkjai vannak. Mindegyiknek egyedi kulcsa van.
- Az egyik flottát egyedileg azonosítja a deviceIdtulajdonság. Egy másik flotta esetében az egyedi tulajdonság objectId. Egyik flotta sem tartalmazza a másik flotta egyedi tulajdonát. Ebben a példában két kulcsot, deviceId és objectIdválasztana 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özparkon belül.
- Ön intelligens épületek gyártója, és érzékelőket helyez üzembe minden szobában. Az egyes helyiségekben általában ugyanazok az értékek vannak a sensorIdszámára. Ilyen például érzékelő1, érzékelő2és érzékelő3.
- Az épület különböző helyszíneken átfedő emelet- és szobaszámokkal rendelkezik a flrRmszámú ingatlanban. Ezek a számok olyan értékekkel rendelkeznek, mint az 1a, 2b, és 3a.
- Van egy tulajdonsága,hely, 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ősorazonosító-kulcsként: sensorId, flrRmés hely.
Példa nyers eseményre:
{
"sensorId": "sensor1",
"flrRm": "1a",
"location": "Redmond",
"temperature": 78
}
Az Azure Portalon ezután a következőképpen adhatja meg az összetett kulcsot:
Jegyzet
Az Azure Portalon 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ágok nevét a saját texboxában.
Következő lépések
Olvassa el az JSON-simítási és menekülési szabályokat az események tárolási módjának megértéséhez.
Tervezze meg Azure Time Series Insights Gen2-környezetet.