Zmienne modelu szeregów czasowych

Uwaga

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: liczbowego, podzielonego na kategorie i agregacji.

• Rodzaje liczbowe działają z ciągłymi wartościami liczbowymi.
• Rodzaje kategorii współpracują ze zdefiniowanym zestawem wartości dyskretnych.
• Rodzaje 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.

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 albo Long zgodne z typem danych przychodzących.
Interpolacja zmiennych	Interpolacja określa, jak odtworzyć sygnał przy użyciu istniejących danych. Opcje interpolacji krokowej i liniowej są dostępne dla zmiennych liczbowych.
Agregacja zmiennych	Wykonywanie obliczeń za pomocą obsługiwanych funkcji agregacji dla rodzajó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 rodzaju kategorii muszą być Long albo String zgodne z typem danych przychodzących.
Interpolacja zmiennych	Interpolacja określa, jak odtworzyć sygnał przy użyciu istniejących danych. Opcja Interpolacji kroków jest dostępna dla zmiennych kategorii.
Kategorie zmiennych	Kategorie tworzą mapowanie między wartościami pochodzącymi z urządzenia lub czujników do etykiety.
Kategoria domyślna 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	Wykonywanie obliczeń za pomocą obsługiwanych funkcji agregacji dla typów zmiennych agregacji.

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 modelu szeregów czasowych i mogą być udostępniane w tekście 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.

• Przeczytaj więcej na temat sposobu definiowania zmiennych wbudowanych przy użyciu interfejsów API zapytań.