Zplošťování, uvozování a zpracování polí JSON

Vaše prostředí Azure Time Series Insights Gen2 bude dynamicky vytvářet sloupce vašich teplých a studených obchodů podle konkrétní sady zásad vytváření názvů. Při ingestování události se na datové části JSON a názvy vlastností použije sada pravidel. Patří sem escaping určitých speciálních znaků a zploštění vnořených objektů JSON. Tato pravidla je důležité znát, abyste pochopili, jak bude tvar JSON ovlivnit způsob ukládání a dotazování událostí. Úplný seznam pravidel najdete v následující tabulce. Příklady A &B také ukazují, jak můžete efektivně dávkot více časových řad v poli.

Principy duálního chování polí

Pole objektů budou buď uložená jako celek, nebo se rozdělí na několik událostí v závislosti na tom, jak jste modelovali data. To vám umožní použít pole pro dávkové události a vyhnout se opakování vlastností telemetrie, které jsou definovány na úrovni kořenového objektu. Dávkování může být výhodné, protože výsledkem je méně odeslaných zpráv Event Hubs nebo IoT Hub.

V některých případech jsou pole obsahující objekty smysluplné pouze v kontextu jiných hodnot. Vytvoření více událostí by vykreslovalo data bez významu. Pokud chcete zajistit, aby pole objektů bylo uloženo jako dynamický typ, postupujte podle pokynů pro modelování dat níže a podívejte se na příklad C.

Jak zjistit, jestli pole objektů vytvoří více událostí

Pokud je vnořená jedna nebo více z id časové řady Time Series propert(ies) v rámci objektů v poli nebo pokud je vlastnost časového razítka zdroje událostí vnořená, modul pro příjem dat ho rozdělí, aby vytvořil více událostí. Názvy vlastností, které jste zadali pro vaše ID TS a/nebo časové razítko, by se měly řídit výše uvedenými pravidly pro zploštění, a proto budou označovat tvar vašeho KÓDU JSON. Podívejte se na následující příklady a podívejte se na průvodce výběrem vlastnosti ID časové řady.

Příklad A

ID časové řady v kořenovém adresáři objektu a vnořeném časovém razítku
ID časové řady prostředí: "id"
Časové razítko zdroje událostí: "values.time"
Datová část JSON:

[
    {
        "id": "caaae533-1d6c-4f58-9b75-da102bcc2c8c",
        "values": [
            {
                "time": "2020-05-01T00:59:59.000Z",
                "value": 25.6073
            },
            {
                "time": "2020-05-01T01:00:29.000Z",
                "value": 43.9077
            }
        ]
    },
    {
        "id": "1ac87b74-0865-4a07-b512-56602a3a576f",
        "values": [
            {
                "time": "2020-05-01T00:59:59.000Z",
                "value": 0.337288
            },
            {
                "time": "2020-05-01T01:00:29.000Z",
                "value": 4.76562
            }
        ]
    }
]

Výsledek v souboru Parquet:
Výše uvedená konfigurace a datová část vytvoří tři sloupce a čtyři události.

Příklad B

ID složené časové řady s jednou vnořenou vlastností
ID časové řady prostředí: "plantId" a "telemetry.tagId"
Časové razítko zdroje událostí: "timestamp"
Datová část JSON:

[
    {
        "plantId": "9336971",
        "timestamp": "2020-01-22T16:38:09Z",
        "telemetry": [
            {
                "tagId": "100231-A-A6",
                "tagValue": -31.149018
            },
            {
                "tagId": "100231-A-A1",
                "tagValue": 20.560796
            },
            {
                "tagId": "100231-A-A9",
                "tagValue": 177
            },
            {
                "tagId": "100231-A-A8",
                "tagValue": 420
            },
        ]
    },
    {
        "plantId": "9336971",
        "timestamp": "2020-01-22T16:42:14Z",
        "telemetry": [
            {
                "tagId": "103585-A-A7",
                "value": -30.9918
            },
            {
                "tagId": "103585-A-A4",
                "value": 19.960796
            }
        ]
    }
]

Výsledek v souboru Parquet:
Výše uvedená konfigurace a datová část vytvoří čtyři sloupce a šest událostí.

Příklad C

ID a časové razítko časové řady jsou v kořenovém adresáři objektu.
ID časové řady prostředí: "id"
Časové razítko zdroje událostí: "timestamp"
Datová část JSON:

{
    "id": "800500054755",
    "timestamp": "2020-11-01T10:00:00.000Z",
    "datapoints": [{
            "value": 120
        },
        {
            "value": 124
        }
    ]
}

Výsledek v souboru Parquet:
Výše uvedená konfigurace a datová část vytvoří tři sloupce a jednu událost.

Další kroky

• Vysvětlení omezení propustnosti vašeho prostředí