JSON-simítási és -feloldási szabályok közelgő változásai az új környezetekben

  • Cikk

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 alternatív megoldásokba való migrálását a lehető leghamarabb. Az elavulással és a migrálással kapcsolatos további információkért tekintse meg dokumentációnkat.

Fontos

Ezek a módosítások csak az újonnan létrehozott Microsoft Azure Time Series Insights Gen2-környezetekre lesznek alkalmazva. A módosítások nem vonatkoznak az 1. generációs környezetekre.

A Azure Time Series Insights Gen2-környezet dinamikusan hozza létre a tárolási oszlopokat egy adott elnevezési konvenciók alapján. Egy esemény betöltésekor a Time Series Insights szabálykészletet alkalmaz a JSON hasznos adataira és a tulajdonságnevekre. A JSON-adatok simításának és tárolásának változásai 2020 júliusában léptek életbe az új Azure Time Series Insights Gen2-környezetekben. Ez a változás a következő esetekben érinti Önt:

  • A JSON hasznos adatai beágyazott objektumokat tartalmaznak.
  • A JSON hasznos adatai tömböket tartalmaznak.
  • Az alábbi négy speciális karakter bármelyikét használhatja egy JSON-tulajdonságnévben: [\.'
  • Egy vagy több idősor-azonosító tulajdonság egy beágyazott objektumon belül található.

Ha új környezetet hoz létre, és egy vagy több ilyen eset vonatkozik az esemény hasznos adataira, az adatok összesimulnak és másképpen lesznek tárolva. Az alábbi táblázat összefoglalja a módosításokat:

Aktuális szabály Új szabály Például szolgáló JSON Előző oszlop neve Új oszlop neve
A beágyazott JSON egy aláhúzásjellel van elsimolva. A beágyazott JSON-t egy ponttal simítjuk le leválasztóként. {"series" : { "value" : 19.338 }} series_value_double series.value_double
A speciális karakterek nincsenek feloldva. A speciális karaktereket .['\ tartalmazó JSON-tulajdonságnevek a és ']a használatával vannak feloldva.[' A [' és ']a részen belül további menekülési lehetőségek találhatók az idézőjelek és fordított perjelek között. A rendszer egyetlen idézőjelet a következőképpen ír, \' a fordított perjelet pedig a következőként \\: . "Foo's Law Value": "17.139999389648" Foo's Law Value_double ['Foo\'s Law Value']_double
A primitívek tömbjei sztringként vannak tárolva. A primitív típusú tömbök dinamikus típusként vannak tárolva. "values": [154, 149, 147] values_string values_dynamic
Az objektumok tömbjei mindig egybesimulnak, és több eseményt eredményeznek. Ha a tömbben lévő objektumok nem rendelkeznek TS-azonosítóval vagy időbélyeg-tulajdonságokkal, az objektumok tömbje dinamikus típusként lesz tárolva. "values": [{"foo" : 140}, {"bar" : 149}] values_foo_long | values_bar_long values_dynamic

Ha a TS-azonosító és/vagy időbélyeg tulajdonság egy objektumba van ágyazva

Minden új üzembe helyezésnek meg kell egyeznie az új betöltési szabályokkal. Ha például a TS-azonosítója telemetry_tagId, frissítenie kell az Azure Resource Manager-sablonokat vagy az automatikus üzembe helyezési szkripteket a környezeti TS-azonosítóként való konfiguráláshoztelemetry.tagId. Erre a módosításra a beágyazott JSON-ban található eseményforrás időbélyegeinek esetében is szükség van.

Ha a hasznos adat beágyazott JSON- vagy speciális karaktereket tartalmaz, és automatizálja a Time Series Model változókifejezések létrehozását

Frissítse a TypesBatchPut metódust végrehajtó ügyfélkódot az új betöltési szabályoknak megfelelően. Frissítenie kell például egy korábbi idősorkifejezést"value": {"tsx": "$event.series_value.Double"} az alábbi lehetőségek egyikére:

  • "value": {"tsx": "$event.series.value.Double"}
  • "value": {"tsx": "$event['series']['value'].Double"}

Következő lépések