A hosszú adattípus támogatása az Azure Time Series Insights Gen2-ben

Feljegyzés

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.

A hosszú adattípus támogatása csak az Azure Time Series Insights Gen2-környezetekben való tárolását és indexelésének módját befolyásolja. Ha Gen1-környezettel rendelkezik, figyelmen kívül hagyhatja ezeket a módosításokat.

2020. június 29-től vagy 2020. június 30-tól kezdve a régiótól függően az adatok hosszú és dupla indexeléssel lesznek indexelve. Ha bármilyen kérdése vagy aggálya van a módosítással kapcsolatban, küldjön támogatási jegyet az Azure Portalon keresztül, és említse meg ezt a kommunikációt.

Ha az alábbi esetek bármelyike érinti, végezze el az ajánlott módosításokat:

• 1. eset: Jelenleg idősormodell változókat használ, és csak integrált adattípusokat küld a telemetriai adatokba.
• 2. eset: Jelenleg idősormodell változókat használ, és a telemetriai adatokban integrál és nemintegráns adattípusokat is küld.
• 3. eset: Kategorikus változókkal egész számértékeket rendelhet kategóriákhoz.
• 4. eset: A JavaScript SDK-val egyéni előtéralkalmazást hozhat létre.
• 5. eset: Közeledik az 1000 tulajdonságra vonatkozó névkorlát a Warm Store-ban, és integrál és nem belső adatokat is küld. A tulajdonságszám metrikaként tekinthető meg az Azure Portalon.

Ha az esetek bármelyike vonatkozik Önre, módosítsa a modellt. Frissítse az idősorkifejezést (TSX) a változódefinícióban az ajánlott módosításokkal. Frissítse mindkettőt:

• Azure Time Series Insights Explorer
• Bármely egyéni ügyfél, amely az API-kat használja

Az IoT-megoldástól és a korlátozásoktól függően előfordulhat, hogy nem rendelkezik az Azure Time Series Insights Gen2-környezetbe küldött adatokkal. Ha nem biztos abban, hogy az adatok csak integrál, vagy integrál és nem integrál jellegűek, néhány lehetőség közül választhat:

• Megvárhatja a funkció kiadását. Ezután vizsgálja meg a nyers eseményeket az Explorer felhasználói felületén, hogy megismerje, mely tulajdonságokat menti két különálló oszlop.
• Az összes numerikus címke esetében előre elvégezheti az ajánlott módosításokat.
• Ideiglenesen átirányíthatja az események egy részhalmazát a tárolóba, hogy jobban megértse és megismerje a sémát.

Az események tárolásához kapcsolja be az Azure Event Hubs eseményrögzítését , vagy az IoT Hubról az Azure Blob Storage-ba való átirányítást .

Az adatok az Event Hub Exploreren vagy az Eseményfeldolgozó állomáson keresztül is megfigyelhetők.

Ha IoT Hubot használ, nyissa meg a beépített végpont eszközről felhőbe irányuló üzeneteinek olvasása lehetőséget a beépített végpont eléréséhez.

Feljegyzés

Ha nem hajtja végre a javasolt módosításokat, fennakadást tapasztalhat. Az érintett Time Series Insights-változók például, amelyek a lekérdezési API-k vagy a Time Series Insights Explorer segítségével érhetők el, null értéket adnak vissza (vagyis nem jelennek meg adatok az explorerben).

Javasolt módosítások

1. eset: Time Series Model változók használata és csak integrál adattípusok küldése telemetriai adatokban

Az 1. eset javasolt módosításai megegyeznek a 2. esetével. Kövesse a 2. esethez tartozó szakasz utasításait.

2. eset: Idősormodell változóinak használata, valamint az integrál- és nemintegrális típusok küldése telemetriai adatokban

Ha jelenleg egész szám típusú telemetriai adatokat küld, az adatok két oszlopra lesznek osztva:

• propertyValue_double
• propertyValue_long

Az egész szám az propertyValue_long ír. A korábban betöltött (és a jövőben betöltött) numerikus adatok nem lesznek átmásolva propertyValue_double .

Ha a propertyValue tulajdonság ezen két oszlopában szeretne adatokat lekérdezni, a Skaláris skaláris függvényt kell használnia a TSX-ben. A függvény elfogadja ugyanannak a DataType-nak az argumentumait, és az argumentumlistában az első nem null értéket adja vissza. További információ: Azure Time Series Insights Gen2 adathozzáférési fogalmak.

Változódefiníció a TSX-ben – numerikus

Korábbi változódefiníció:

Új változódefiníció:

A coalesce($event.propertyValue.Double, toDouble($event.propertyValue.Long)) is használható egyéni idősor-kifejezésként.

Beágyazott változódefiníció TSX lekérdezési API-kkal – numerikus

Korábbi változódefiníció:

"PropertyValueVariable": {

    "kind": "numeric",

    "value": {

        "tsx": "$event.propertyValue.Double"

    },

    "filter": null,

    "aggregation": {

        "tsx": "avg($value)"
    }
}

Új változódefiníció:

"PropertyValueVariable ": {

    "kind": "numeric",

    "value": {

        "tsx": "coalesce($event.propertyValue.Long, toLong($event.propertyValue.Double))"

    },

    "filter": null,

    "aggregation": {

        "tsx": "avg($value)"
    }
}

A coalesce($event.propertyValue.Double, toDouble($event.propertyValue.Long)) is használható egyéni idősor-kifejezésként.

Feljegyzés

Javasoljuk, hogy frissítse ezeket a változókat minden olyan helyen, ahol esetleg használni lehet őket. Ezek a helyek közé tartoznak a Time Series Model, a mentett lekérdezések és a Power BI-összekötő lekérdezései.

3. eset: Kategorikus változók használata egész számértékek kategóriákhoz való leképezéséhez

Ha jelenleg olyan kategorikus változókat használ, amelyek egész számértékeket képeznek le kategóriákra, akkor valószínűleg a toLong függvénnyel konvertálja az adatokat Dupla típusról Hosszú típusra. Az 1. és a 2. esethez hasonlóan a Dupla és a Hosszú DataType oszlopot is egyesítenie kell.

Változódefiníció a Time Series Explorerben – kategorikus

Korábbi változódefiníció:

Új változódefiníció:

A coalesce($event.propertyValue.Double, toDouble($event.propertyValue.Long)) is használható egyéni idősor-kifejezésként.

A kategorikus változókhoz továbbra is egész típusú értékre van szükség. A coalesce() argumentumainak DataType típusának hosszú típusúnak kell lennie az egyéni idősor-kifejezésben.

Beágyazott változódefiníció TSX lekérdezési API-kkal – kategorikus

Korábbi változódefiníció:

"PropertyValueVariable_Long": {

    "kind": "categorical",

    "value": {

        "tsx": "tolong($event.propertyValue.Double)"

    },

    "categories": [

    {
        "label": "Good",

        "values": [0, 1, 2 ]

    },

    {

        "label": "Bad",

        "values": [ 3, 4 ]

    } ],

    "defaultCategory": {

        "label": "Unknown"

    }
}

Új változódefiníció:

"PropertyValueVariable_Long": {

    "kind": "categorical",

    "value": {

        "tsx": "coalesce($event.propertyValue.Long, tolong($event.propertyValue.Double))"

    },

    "categories": [

    {
        "label": "Good",

        "values": [0, 1, 2 ]

    },

    {

        "label": "Bad",

        "values": [ 3, 4 ]

    } ],

    "defaultCategory": {

        "label": "Unknown"

    }
}

A kategorikus változókhoz továbbra is egész típusú értékre van szükség. A coalesce() argumentumainak DataType típusának hosszú típusúnak kell lennie az egyéni idősor-kifejezésben.

Feljegyzés

Javasoljuk, hogy frissítse ezeket a változókat minden olyan helyen, ahol esetleg használni lehet őket. Ezek a helyek közé tartoznak a Time Series Model, a mentett lekérdezések és a Power BI-összekötő lekérdezései.

4. eset: Egyéni előtérbeli alkalmazás létrehozása a JavaScript SDK használatával

Ha az 1–3. eset érinti, és egyéni alkalmazásokat hoz létre, frissítenie kell a lekérdezéseket a coalesce() függvény használatához, ahogyan az az előző példákban is látható.

5. eset: A Meleg tároló 1000 tulajdonságkorlátjának közelében

Ha Ön nagy számú tulajdonsággal rendelkező Warm Store-felhasználó, és úgy véli, hogy ez a módosítás a környezetét az 1000 Warm Store tulajdonságnévkorlát fölé helyezi, küldjön támogatási jegyet az Azure Portalon, és említse meg ezt a kommunikációt.

Következő lépések

• A támogatott adattípusok teljes listájának megtekintése.