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.