Condividi tramite


Procedure consigliate per la scelta di un ID serie temporale

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.

Questo articolo riepiloga l'importanza dell'ID serie temporale per l'ambiente Azure Time Series Insights Gen2 e le procedure consigliate per sceglierne una.

Scegliere un ID serie temporale

La selezione di un ID serie temporale appropriato è fondamentale. Scegliere un ID serie temporale è come scegliere una chiave di partizione per un database. È necessario quando si crea un ambiente Azure Time Series Insights Gen2.

Per una spiegazione dettagliata dell'ID serie temporale, vedere l'esercitazione sul provisioning dell'ambiente. Verranno visualizzati due diversi esempi di payload di telemetria JSON e la selezione corretta dell'ID serie temporale per ognuna.

Importante

Gli ID serie temporale sono:

  • Una proprietà stringa con distinzione tra maiuscole e minuscole: lettere e maiuscole/minuscole vengono usate nelle ricerche, nei confronti, negli aggiornamenti e durante il partizionamento.
  • Proprietà non modificabile : una volta creata non può essere modificata.

Suggerimento

Se l'origine evento è un hub IoT, è probabile che l'ID serie temporale sia iothub-connection-device-id. Se si prevede di usare Plug and Play IoT modelli di dispositivo o li usano senza componenti, è necessario includere dt-subject come parte della chiave composita nel caso in cui sia necessario in futuro.

Le procedure consigliate principali da seguire includono:

  • Selezionare una chiave di partizione con molti valori distinti, ad esempio centinaia o migliaia. In molti casi, questo potrebbe essere l'ID del dispositivo, l'ID sensore o l'ID tag nel codice JSON.
  • L'ID serie temporale deve essere univoco a livello di nodo foglia del modello serie temporale.
  • Il limite di caratteri per la stringa del nome della proprietà dell'ID serie temporale è 128. Per il valore della proprietà dell'ID serie temporale, il limite di caratteri è 1.024.
  • Se manca un valore di proprietà univoco per l'ID serie temporale, viene considerato come un valore Null e segue la stessa regola del vincolo di univocità.
  • Se l'ID serie temporale è annidato all'interno di un oggetto JSON complesso, assicurarsi di seguire le regole di flating in ingresso quando si specifica il nome della proprietà. Vedere l'esempio B.
  • È anche possibile selezionare fino a tre proprietà chiave come ID serie temporale. La combinazione sarà una chiave composta che rappresenta l'ID serie temporale.

    Nota

    Le tre proprietà chiave devono essere stringhe. È necessario eseguire una query su questa chiave composita anziché su una proprietà alla volta.

Selezionare più proprietà chiave

Gli scenari seguenti descrivono la selezione di più proprietà chiave come ID serie temporale.

Esempio 1: ID serie temporale con una chiave univoca

  • Si dispone di flotta legacy di asset. Ognuno ha una chiave univoca.
  • Una flotta viene identificata in modo univoco dalla proprietà deviceId. Per un'altra flotta, la proprietà univoca è objectId. Nessuna flotta contiene la proprietà univoca dell'altra flotta. In questo esempio si selezionano due chiavi, deviceId e objectId, come chiavi univoce.
  • Si accettano valori Null e la mancanza di presenza di una proprietà nel payload dell'evento viene conteggiato come valore Null. Questo è anche il modo appropriato per gestire l'invio di dati a due origini evento in cui i dati in ogni origine evento hanno un ID serie temporale univoco.

Esempio 2: ID serie temporale con una chiave composta

  • È necessario che più proprietà siano univoche nella stessa flotta di asset.
  • Si è un produttore di edifici intelligenti e si distribuiscono sensori in ogni stanza. In ogni stanza si hanno in genere gli stessi valori per sensorId. Esempi sono sensor1, sensor2 e sensor3.
  • L'edificio ha numeri di stanza e pavimento sovrapposti tra siti nella proprietà flrRm. Questi numeri hanno valori come 1a, 2b e 3a.
  • Si dispone di una proprietà, una posizione, che contiene valori come Redmond, Barcellona e Tokyo. Per creare un'univocità, designare le tre proprietà seguenti come chiavi ID serie temporale: sensorId, flrRm e posizione.

Esempio di evento non elaborato:

{
  "sensorId": "sensor1",
  "flrRm": "1a",
  "location": "Redmond",
  "temperature": 78
}

Nella portale di Azure è quindi possibile immettere la chiave composita come segue:

Configure l'ID serie temporale per l'ambiente.

Nota

In portale di Azure non immettere nomi delimitati da virgole di proprietà in una texbox. In caso contrario, verrà considerato come un singolo nome di proprietà che contiene virgole. Immettere ogni nome di proprietà nel proprio texbox.

Passaggi successivi

  • Leggere le regole json flat e di escape per comprendere come verranno archiviati gli eventi.

  • Pianificare l'ambiente Azure Time Series Insights Gen2.