Megosztás a következőn keresztül:


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:

Idősor-azonosító konfigurálása a környezet számára.

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