Zmienne modelu szeregów czasowych

Notatka

Usługa Time Series Insights zostanie wycofana 7 lipca 2024 r. Rozważ migrację istniejących środowisk do alternatywnych rozwiązań tak szybko, jak to możliwe. Aby uzyskać więcej informacji na temat wycofywania i migracji, odwiedź naszą dokumentację .

W tym artykule opisano zmienne modelu szeregów czasowych, które określają reguły formuły i obliczeń dla zdarzeń.

Każda zmienna może być jednym z trzech rodzajów: liczbowa, kategorycznai agregacyjna.

• Rodzaje liczbowe działają z ciągłymi wartościami liczbowymi.
• Kategorie rodzajów działają z określonym zestawem wartości dyskretnych.
• typy agregacji łączą wiele zmiennych jednego rodzaju (wszystkie liczbowe lub wszystkie kategorie).

W poniższej tabeli przedstawiono właściwości istotne dla każdego rodzaju zmiennej.

tabela zmiennych

Zmienne liczbowe

Właściwość zmiennej	Opis
Filtr zmiennych	Filtry są opcjonalnymi klauzulami warunkowymi, aby ograniczyć liczbę wierszy rozważanych do obliczeń.
Wartość zmiennej	Wartości telemetryczne używane do obliczeń pochodzących z urządzenia lub czujników lub przekształcone przy użyciu wyrażeń szeregów czasowych. Zmienne rodzaju liczbowego muszą być Double lub Long, aby pasowały do typu danych otrzymywanych.
Interpolacja zmiennych	Interpolacja określa, jak odtworzyć sygnał przy użyciu istniejących danych. Opcje interpolacji kroków i liniowych są dostępne dla zmiennych liczbowych.
Agregacja zmiennych	Wykonywanie obliczeń za pomocą obsługiwanych funkcji agregacji dla typów zmiennych liczbowych.

Zmienne są zgodne z następującym przykładem JSON:

"Interpolated Speed": {
  "kind": "numeric",
  "value": {
    "tsx": "$event['Speed-Sensor'].Double"
  },
  "filter": null,
  "interpolation": {
    "kind": "step",
    "boundary": {
      "span": "P1D"
    }
  },
  "aggregation": {
    "tsx": "right($value)"
  }
}

Zmienne podzielone na kategorie

Właściwość zmiennej	Opis
Filtr zmiennych	Filtry są opcjonalnymi klauzulami warunkowymi, aby ograniczyć liczbę wierszy rozważanych do obliczeń.
Wartość zmiennej	Wartości telemetryczne używane do obliczeń pochodzących z urządzenia lub czujników. Zmienne kategoryczne muszą być Long lub String, aby były zgodne z typem danych przychodzących.
Interpolacja zmiennych	Interpolacja określa, jak odtworzyć sygnał przy użyciu istniejących danych. Opcja interpolacji kroku jest dostępna dla zmiennych kategorycznych.
Kategorie zmiennych	Kategorie tworzą mapowanie między wartościami pochodzącymi z urządzenia lub czujników do etykiety.
Domyślna kategoria zmiennej	Domyślna kategoria dotyczy wszystkich wartości, które nie są mapowane we właściwości "categories".

Zmienne są zgodne z następującym przykładem JSON:

"Status": {
  "kind": "categorical",
  "value": {
     "tsx": "$event.Status.Long"
},
  "interpolation": {
    "kind": "step",
    "boundary": {
      "span" : "PT1M"
    }
  },
  "categories": [
    {
      "values": [0, 1, 2, 3],
      "label": "Good"
    },
    {
      "values": [4],
      "label": "Bad"
    }
  ],
  "defaultCategory": {
    "label": "Not Applicable"
  }
}

Zmienne agregowane

Właściwość zmiennej	Opis
Filtr zmiennych	Filtry są opcjonalnymi klauzulami warunkowymi, aby ograniczyć liczbę wierszy rozważanych do obliczeń.
Agregacja zmiennych	Wykonaj obliczenia za pomocą obsługiwanych funkcji agregacyjnych dla typów zmiennej agregacyjnej.

Zmienne są zgodne z następującym przykładem JSON:

"Speed Range": {
  "kind": "aggregate",
  "filter": null,
  "aggregation": {
    "tsx": "max($event.Speed.Double) - min($event.Speed.Double)"
  }
}

Zmienne są przechowywane w definicji typu dla modelu szeregów czasowych i mogą być przekazywane bezpośrednio za pośrednictwem interfejsów API w celu zastąpienia lub uzupełnienia przechowywanej definicji.

Następne kroki

• Dowiedz się więcej o modelu szeregów czasowych.

• Dowiedz się więcej o tym, jak definiować zmienne w wierszu przy użyciu interfejsów API zapytań .