Appiattimento JSON, escape e gestione delle matrici

L'ambiente Azure Time Series Insights Gen2 creerà dinamicamente le colonne degli archivi ad accesso frequente e sporadico, seguendo un determinato set di convenzioni di denominazione. Quando viene inserito un evento, viene applicato un set di regole ai nomi di payload e proprietà JSON. Questi includono l'escape di determinati caratteri speciali e l'appiattimento di oggetti JSON annidati. È importante conoscere queste regole in modo da comprendere come la forma del codice JSON influirà sulla modalità di archiviazione e query degli eventi. Vedere la tabella seguente per l'elenco completo delle regole. Esempi A & B illustrano anche come si è in grado di raggruppare in modo efficiente più serie temporali in una matrice.

Informazioni sul doppio comportamento per le matrici

Le matrici di oggetti verranno archiviate intere o suddivise in più eventi a seconda della modalità di modellazione dei dati. In questo modo è possibile usare una matrice per inviare in batch gli eventi ed evitare di ripetere le proprietà di telemetria definite a livello di oggetto radice. L'invio in batch può essere vantaggioso perché comporta un minor numero di messaggi dell'hub eventi o dell'hub IoT inviati.

In alcuni casi, tuttavia, le matrici contenenti oggetti sono significative solo nel contesto di altri valori. La creazione di più eventi renderebbe i dati senza significato. Per assicurarsi che una matrice di oggetti sia archiviata così com'è come tipo dinamico, seguire le indicazioni sulla modellazione dei dati di seguito e osservare l'esempio C

Come sapere se la matrice di oggetti produrrà più eventi

Se una o più proprietà ID serie temporale sono annidate all'interno di oggetti in una matrice o, se la proprietà timestamp dell'origine evento è annidata, il motore di inserimento la dividerà per creare più eventi. I nomi delle proprietà forniti per il/gli ID TS e/o il timestamp devono seguire le regole di appiattimento precedenti e indicherà quindi la forma del file JSON. Vedere gli esempi seguenti ed esaminare la guida su come selezionare una proprietà ID serie temporale.

Esempio A

ID serie temporale nella radice dell'oggetto e nel timestamp annidato
ID serie temporale dell'ambiente:"id"
Timestamp origine evento:"values.time"
Payload 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
            }
        ]
    }
]

Risultato nel file Parquet:
La configurazione e il payload precedenti produrranno tre colonne e quattro eventi

Esempio B

ID serie temporale composita con una proprietà annidata
ID serie temporale dell'ambiente: "plantId" e "telemetry.tagId"
Timestamp origine evento: "timestamp"
Payload 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
            }
        ]
    }
]

Risultato nel file Parquet:
La configurazione e il payload precedenti produrranno quattro colonne e sei eventi

Esempio C

ID serie temporale e timestamp si trovano nella radice dell'oggetto
ID serie temporale dell'ambiente:"id"
Timestamp origine evento: "timestamp"
Payload JSON:

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

Risultato nel file Parquet:
La configurazione e il payload precedenti produrranno tre colonne e un evento

Passaggi successivi

• Comprendere le limitazioni della velocità effettiva dell'ambiente