Metodtips för att välja Time Series ID-värde

  • Artikel
  • 2 minuter för att läsa

I den här artikeln sammanfattas vikten av Tidsserie-ID för din Azure Time Series Insights Gen2-miljö och metodtips för att välja en.

Välj ett Time Series-ID

Det är viktigt att du väljer ett lämpligt tidsserie-ID. Att välja ett Tidsserie-ID är som att välja en partitionsnyckel för en databas. Det krävs när du skapar en Azure Time Series-miljö Insights Gen2.

Titta på självstudien om miljöetablering för en detaljerad förklaring av Tidsserie-ID. Du ser två olika exempel på JSON-telemetrinyttolaster och rätt val av tidsserie-ID för var och en.

Viktigt

Tidsserie-ID:er är:

  • En case-sensitive string-egenskap: bokstavs- och teckenhöljen används i sökningar, jämförelser, uppdateringar och vid partitionering.
  • En oföränderlig egenskap: när den har skapats kan den inte ändras.

Tips

Om din händelsekälla är en IoT-hubb är ditt Time Series-ID troligen iothub-connection-device-id. Om du planerar att använda IoT Plug and Play-enhetsmodeller eller använder dem utan komponenter bör du inkludera dt-subject som en del av den sammansatta nyckeln om du behöver den i framtiden.

Viktiga metodtips att följa är:

  • Välj en partitionsnyckel med många distinkta värden (till exempel hundratals eller tusentals). I många fall kan detta vara enhets-ID, sensor-ID eller tagg-ID i din JSON.
  • Tidsserie-ID:t ska vara unikt på lövnodnivå för din tidsseriemodell.
  • Teckengränsen för time series-ID:ts egenskapsnamnssträng är 128. För egenskapsvärdet för Tidsserie-ID är teckengränsen 1 024.
  • Om ett unikt egenskapsvärde för Tidsserie-ID saknas behandlas det som ett null-värde och följer samma regel för unikhetsbegränsningen.
  • Om ditt Tidsserie-ID är kapslat i ett komplext JSON-objekt måste du följa reglerna för utplattning av ingress när du anger ditt egenskapsnamn. Kolla in exempel B.
  • Du kan också välja upp till tre viktiga egenskaper som tidsserie-ID. Kombinationen är en sammansatt nyckel som representerar tidsserie-ID:t.

    Anteckning

    Dina tre nyckelegenskaper måste vara strängar. Du skulle behöva fråga mot den här sammansatta nyckeln i stället för en egenskap i taget.

Välj fler än en nyckelegenskap

I följande scenarier beskrivs hur du väljer fler än en nyckelegenskap som time series-ID.

Exempel 1: Tidsserie-ID med en unik nyckel

  • Du har äldre tillgångsparker. Var och en har en unik nyckel.
  • En vagnpark identifieras unikt av egenskapen deviceId. För en annan vagnpark är den unika egenskapen objectId. Ingen av vagnparkerna innehåller den andra vagnparks unika egenskapen. I det här exemplet väljer du två nycklar, deviceId och objectId, som unika nycklar.
  • Vi accepterar null-värden och bristen på en egenskaps närvaro i händelsenyttolasten räknas som ett null-värde. Detta är också ett lämpligt sätt att hantera sändning av data till två händelsekällor där data i varje händelsekälla har ett unikt tidsserie-ID.

Exempel 2: Tidsserie-ID med en sammansatt nyckel

  • Du kräver att flera egenskaper är unika inom samma tillgångspark.
  • Du tillverkar smarta byggnader och distribuerar sensorer i alla rum. I varje rum har du vanligtvis samma värden för sensorId. Exempel är sensor1, sensor2 och sensor3.
  • Din byggnad har överlappande golv- och rumsnummer över flera platser i egenskapen flrRm. Dessa tal har värden som 1a, 2b och 3a.
  • Du har en egenskap, plats, som innehåller värden som Redmond, Tokyo och. För att skapa unikhet anger du följande tre egenskaper som dina Time Series ID-nycklar: sensorId, flrRm och plats.

Exempel på råhändelse:

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

I Azure Portal kan du ange den sammansatta nyckeln på följande sätt:

Konfigurera tidsserie-ID för miljön.

Anteckning

I Azure Portal anger du inte kommaavgränsade namn på egenskaper i en texasbox, annars behandlas det som ett enda egenskapsnamn som innehåller kommatecken. Ange varje egenskapsnamn i en egen texasbox.

Nästa steg