Udostępnij za pośrednictwem

Zmienne modelu szeregów czasowych

  • Artykuł

Uwaga

Usługa Time Series Insights (TSI) nie będzie już obsługiwana po marcu 2025 r. Rozważ migrację istniejących środowisk TSI 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ń na zdarzeniach.

Każda zmienna może być jedną z trzech rodzajów: liczbową, kategoryczną i agregowaną.

  • Rodzaje liczbowe działają z wartościami liczbowymi ciągłymi.
  • 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 odpowiednie dla każdego rodzaju zmiennej.

Tabela zmiennych modelu szeregów czasowych

Zmienne liczbowe

Właściwość zmiennej Opis
Filtr zmiennej 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 typu liczbowego muszą być zgodne Double z Long 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 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 kategorii

Właściwość zmiennej Opis
Filtr zmiennej 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 rodzajowe kategorii muszą być albo LongString 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 zmiennej 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