Wykonywanie zapytań dotyczących danych z usługi Azure Time Series Insights Gen2

  • 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ę.

Azure Time Series Insights Gen2 umożliwia wykonywanie zapytań dotyczących danych dotyczących zdarzeń i metadanych przechowywanych w środowisku za pośrednictwem publicznych interfejsów API powierzchni. Te interfejsy API są również używane przez eksploratora usługi Azure Time Series Insights TSI.

W usłudze Azure Time Series Insights Gen2 są dostępne trzy główne kategorie interfejsów API:

  • Interfejsy API środowiska: te interfejsy API umożliwiają wykonywanie zapytań w samym środowisku Azure Time Series Insights Gen2. Mogą one służyć do zbierania listy środowisk, do których obiekt wywołujący ma dostęp do metadanych środowiska i .
  • Interfejsy API Model-Query szeregów czasowych (TSM-Q): umożliwia tworzenie, odczytywanie, aktualizowanie i usuwanie (CRUD) operacji na metadanych przechowywanych w modelu szeregów czasowych środowiska. Mogą one służyć do uzyskiwania dostępu do wystąpień, typów i hierarchii oraz edytowania ich.
  • Interfejsy API zapytań szeregów czasowych (TSQ): umożliwia pobieranie danych telemetrycznych lub zdarzeń w miarę ich rejestrowania od dostawcy źródłowego oraz umożliwia wykonywanie obliczeń i agregacji danych przy użyciu zaawansowanych funkcji skalarnych i agregujących.

Azure Time Series Insights Gen2 używa zaawansowanego języka wyrażeń opartych na ciągach, wyrażenia szeregów czasowych (TSX) do wyrażania obliczeń w zmiennych szeregów czasowych.

Omówienie interfejsów API usługi Azure Time Series Insights Gen2

Obsługiwane są następujące podstawowe interfejsy API.

Omówienie zapytania szeregów czasowych

Interfejsy API środowiska

Interfejsy API Model-Query szeregów czasowych (TSM-Q)

Większość z tych interfejsów API obsługuje operacje wykonywania wsadowego w celu włączenia operacji CRUD wsadowych na wielu jednostkach modelu szeregów czasowych:

  • Interfejs API ustawień modelu: włącza polecenia GET i PATCH dla domyślnego typu i nazwy modelu środowiska.
  • Interfejs API typów: włącza operację CRUD dla typów szeregów czasowych i skojarzonych z nimi zmiennych.
  • Interfejs API hierarchii: włącza operację CRUD w hierarchiach szeregów czasowych i skojarzonych z nimi ścieżkach pól.
  • Interfejs API wystąpień: włącza operację CRUD w wystąpieniach szeregów czasowych i skojarzonych z nimi polach wystąpienia. Ponadto interfejs API wystąpień obsługuje następujące operacje:
    • Wyszukiwanie: pobiera częściową listę trafień dla wystąpień szeregów czasowych na podstawie atrybutów wystąpienia.
    • Sugerowanie: wyszukuje i sugeruje częściową listę trafień na potrzeby wyszukiwania wystąpień szeregów czasowych na podstawie atrybutów wystąpienia.

Interfejsy API zapytań szeregów czasowych (TSQ)

Te interfejsy API są dostępne w obu magazynach (ciepłych i zimnych) w naszym wielowarstwowym rozwiązaniu magazynu.

  • Interfejs API pobierania zdarzeń: umożliwia wykonywanie zapytań i pobieranie nieprzetworzonych zdarzeń oraz skojarzonych sygnatur czasowych zdarzeń zarejestrowanych w usłudze Azure Time Series Insights Gen2 od dostawcy źródłowego. Ten interfejs API umożliwia pobieranie nieprzetworzonych zdarzeń dla danego identyfikatora szeregów czasowych i zakresu wyszukiwania. Ten interfejs API obsługuje stronicowanie w celu pobrania kompletnego zestawu danych odpowiedzi dla wybranych danych wejściowych.

    Ważne

    W ramach nadchodzących zmian w regułach spłaszczania i ucieczki w formacie JSON tablice będą przechowywane jako typ dynamiczny . Właściwości ładunku przechowywane jako tego typu są dostępne tylko za pośrednictwem interfejsu API pobierania zdarzeń.

  • Interfejs API pobierania serii: umożliwia wykonywanie zapytań i pobieranie obliczonych wartości oraz skojarzonych sygnatur czasowych zdarzeń przez zastosowanie obliczeń zdefiniowanych przez zmienne dla nieprzetworzonych zdarzeń. Te zmienne można zdefiniować w modelu szeregów czasowych lub w tekście w zapytaniu. Ten interfejs API obsługuje stronicowanie w celu pobrania kompletnego zestawu danych odpowiedzi dla wybranych danych wejściowych.

  • Interfejs API agregacji serii: umożliwia wykonywanie zapytań i pobieranie zagregowanych wartości oraz skojarzonych sygnatur czasowych interwału przez zastosowanie obliczeń zdefiniowanych przez zmienne dla nieprzetworzonych zdarzeń. Te zmienne można zdefiniować w modelu szeregów czasowych lub w tekście w zapytaniu. Ten interfejs API obsługuje stronicowanie w celu pobrania kompletnego zestawu danych odpowiedzi dla wybranych danych wejściowych.

    Dla określonego zakresu wyszukiwania i interwału ten interfejs API zwraca zagregowaną odpowiedź na interwał na zmienną dla identyfikatora szeregów czasowych. Liczba interwałów w zestawie danych odpowiedzi jest obliczana przez zliczanie cykli epok (liczba milisekund, które upłynęły od epoki systemu Unix — 1 stycznia 1970 r.) i dzielenie kleszczy według rozmiaru przedziału interwału określonego w zapytaniu.

    Znaczniki czasu zwracane w zestawie odpowiedzi to granice lewego interwału, a nie z zdarzeń próbkowanych z interwału.

Wybieranie typu sklepu

Powyższe interfejsy API mogą być wykonywane tylko względem jednego z dwóch typów magazynów (zimnych lub ciepłych) w jednym wywołaniu. Parametry adresu URL zapytania służą do określania typu magazynu , na którym ma zostać wykonane zapytanie.

Jeśli żaden parametr nie zostanie określony, zapytanie zostanie domyślnie wykonane w magazynie zimnym. Jeśli zapytanie obejmuje zakres czasu nakładających się zarówno w magazynie zimnym, jak i ciepłym, zaleca się kierowanie zapytania do magazynu zimnego w celu uzyskania najlepszego środowiska, ponieważ ciepły magazyn będzie zawierać tylko częściowe dane.

Eksplorator Azure Time Series Insights i łącznik usługi Power BI tworzą wywołania powyższych interfejsów API i automatycznie wybierają prawidłowy parametr storeType, jeśli ma to zastosowanie.

Następne kroki