Procedure consigliate per la scelta di un ID serie temporale

Nota

Il servizio Time Series Insights (TSI) non sarà più supportato dopo marzo 2025. Prendere in considerazione la migrazione degli ambienti TSI esistenti alle soluzioni alternative non appena 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 la scelta di una.

Scegliere un ID serie temporale

La selezione di un ID serie temporale appropriata è 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.

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

Importante

Gli ID serie temporali sono:

• Proprietà stringa con distinzione tra maiuscole e minuscole: le maiuscole e i caratteri vengono usati 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, l'ID serie temporale probabilmente sarà iothub-connection-device-id. Se si prevede di usare Plug and Play IoT modelli di dispositivo o di usarli senza componenti, è necessario includere dt-subject come parte della chiave composita nel caso in cui sia necessario in futuro.

Procedure consigliate chiave 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 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 valore Null e segue la stessa regola del vincolo di univocità.
• Se l'ID serie temporale viene annidato all'interno di un oggetto JSON complesso, assicurarsi di seguire le regole di ingresso flat per specificare 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 composita 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ù di una 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

• Hai una flotta legacy di asset. Ogni oggetto ha una chiave univoca.
• Una flotta viene identificata in modo univoco dal deviceId della proprietà. 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 eventi in cui i dati in ogni origine evento hanno un ID time series univoco.

Esempio 2: ID serie temporale con una chiave composita

• È necessario che più proprietà siano univoche nella stessa flotta di asset.
• Sei un produttore di edifici intelligenti e distribuisci sensori in ogni stanza. In ogni stanza in genere si hanno gli stessi valori per sensorId. Esempi sono sensor1, sensor2 e sensor3.
• L'edificio ha numeri sovrapposti di pavimento e stanza 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 l'univocità, si definiscono 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 indicato di seguito:

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 flattening ed escaping per comprendere come verranno archiviati gli eventi.

• Pianificare l'ambiente Azure Time Series Insights Gen2.