Tipi di dati supportati
Nota
Il servizio Time Series Insights verrà ritirato il 7 luglio 2024. Valutare la possibilità di eseguire la migrazione di ambienti esistenti a soluzioni alternative il prima possibile. Per altre informazioni sulla deprecazione e la migrazione, visitare la documentazione.
La tabella seguente elenca i tipi di dati supportati da Azure Time Series Insights Gen2
| Tipo di dati | Descrizione | Esempio | Sintassi dell'espressione Time Series | Nome colonna proprietà in Parquet |
|---|---|---|---|---|
| bool | Tipo di dati con uno dei due stati: true o false. |
"isQuestionable" : true |
$event.isQuestionable.Bool oppure $event['isQuestionable'].Bool |
isQuestionable_bool |
| datetime | Rappresenta un istante di tempo, in genere espresso come data e ora del giorno. Espresso nel formato ISO 8601. Le proprietà Datetime vengono sempre archiviate in formato UTC. Gli offset del fuso orario, se formattati correttamente, verranno applicati e quindi il valore archiviato in formato UTC. Per altre informazioni sulla proprietà timestamp dell'ambiente e sugli offset datetime, vedere questa sezione | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
Se "eventProcessedLocalTime" è il timestamp dell'origine evento: $event.$ts. Se si tratta di un'altra proprietà JSON: $event.eventProcessedLocalTime.DateTime o $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| double | Numero a 64 bit a precisione doppia | "value": 31.0482941 |
$event.value.Double oppure $event['value'].Double |
value_double |
| long | Intero con segno a 64 bit | "value" : 31 |
$event.value.Long oppure $event['value'].Long |
value_long |
| string | I valori di testo devono essere costituiti da UTF-8 validi. Le stringhe null e vuote vengono trattate allo stesso modo. | "site": "DIM_MLGGG" |
$event.site.String oppure $event['site'].String |
site_string |
| dynamic | Tipo complesso (non primitivo) costituito da una matrice o da un contenitore di proprietà (dizionario). Attualmente solo le matrici JSON stringate di primitive o matrici di oggetti che non contengono l'ID TS o la proprietà timestamp (ies) verranno archiviate come dinamiche. Leggere questo articolo per comprendere in che modo gli oggetti verranno appiattiti e le matrici potrebbero essere annullate. Le proprietà del payload archiviate come questo tipo sono accessibili solo selezionando Explore Events In Esplora Time Series Insights per visualizzare gli eventi non elaborati o tramite l'API Query per l'analisi GetEvents lato client. |
"values": "[197, 194, 189, 188]" |
Il riferimento ai tipi dinamici in un'espressione Time Series non è ancora supportato | values_dynamic |
Nota
Sono supportati valori integer a 64 bit, ma il numero maggiore che Azure Time Series Insights Explorer può esprimere in modo sicuro è 9.007.199.254.740.991 (2^53-1) a causa delle limitazioni di JavaScript. Se si lavora con numeri nel modello di dati precedente, è possibile ridurre le dimensioni creando una variabile modello Time Series e convertendo il valore.
Nota
Il tipo stringa non è nullable:
- Un'espressione Time Series (TSX) espressa in una query time series che confronta il valore di una stringa vuota ('') rispetto a NULL avrà lo stesso comportamento:
$event.siteid.String = NULLequivale a$event.siteid.String = ''. - L'API può restituire valori NULL anche se gli eventi originali contengono stringhe vuote.
- Non accettare dipendenze dai valori NULL nelle colonne String per eseguire confronti o valutazioni, considerarli allo stesso modo di stringhe vuote.
Invio di tipi di dati misti
L'ambiente Azure Time Series Insights Gen2 è fortemente tipizzato. Se i dispositivi o i tag inviano dati di tipi diversi per una proprietà del dispositivo, i valori verranno archiviati in due colonne separate e la funzione coalesce() deve essere usata quando si definiscono le espressioni della variabile del modello Time Series nelle chiamate API.
Azure Time Series Insights Explorer offre un modo per unire automaticamente le colonne separate della stessa proprietà del dispositivo. Nell'esempio seguente il sensore invia una PresentValue proprietà che può essere sia long che double. Per eseguire una query su tutti i valori archiviati (indipendentemente dal tipo di dati) della PresentValue proprietà, scegliere PresentValue (Double | Long) e le colonne verranno uniti automaticamente.
Oggetti e matrici
È possibile inviare tipi complessi, ad esempio oggetti e matrici, come parte del payload dell'evento. Gli oggetti annidati verranno appiattiti e le matrici verranno archiviate come dynamic o appiattite per produrre più eventi a seconda della configurazione dell'ambiente e della forma JSON. Per altre informazioni su JSON Flattening and Escaping Rules