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

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 deprecjacji i migracji, odwiedź naszą dokumentację .

Usługa Azure Time Series Insights Gen2 umożliwia wykonywanie zapytań dotyczących danych zdarzeń i metadanych przechowywanych w środowisku za pośrednictwem publicznych interfejsów API. Interfejsy API są używane także przez Eksplorator TSI Azure Time Series Insights.

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

• API środowiskowe: Te API umożliwiają wykonywanie zapytań w środowisku usługi Azure Time Series Insights Gen2. Mogą one być używane do zbierania listy środowisk, do których obiekt wywołujący ma dostęp, oraz metadanych środowisk.
• Interfejsy API Model-Query szeregów czasowych (TSM-Q): umożliwiają operacje tworzenia, odczytu, aktualizacji i usuwania (CRUD) 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ń podczas rejestrowania od dostawcy źródła i umożliwia wykonywanie obliczeń i agregacji danych przy użyciu zaawansowanych funkcji skalarnych i agregujących.

Usługa 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.

API środowiska

• Pobierz interfejs API środowisk: zwraca listę środowisk, do których obiekt wywołujący ma uprawnienia dostępu.
• Uzyskiwanie interfejsu API dostępności środowisk: zwraca rozkład liczby zdarzeń według znacznika czasu zdarzenia$ts. Ten interfejs API pomaga określić, czy w środowisku istnieją jakiekolwiek zdarzenia, zwracając liczbę zdarzeń podzielonych na interwały czasu, jeśli istnieją.
• API schematu zdarzeń: Zwraca metadane schematu zdarzeń dla danego zakresu wyszukiwania. Ten interfejs API pomaga pobrać wszystkie metadane i właściwości dostępne w schemacie dla danego zakresu wyszukiwania.

API zapytań modelu szeregów czasowych (TSM-Q)

Większość z tych interfejsów API obsługuje operacje wsadowe, aby umożliwić wykonywanie operacji CRUD wsadowych w wielu obiektach Modelu Szeregów Czasowych.

• Interfejs API ustawień modelu: włącza polecenie GET i PATCH dla domyślnego typu oraz nazwę 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 ze nimi ścieżkach pól.
• Interfejs API wystąpień: włącza operację CRUD w wystąpieniach szeregów czasowych i skojarzonych polach wystąpień. Ponadto interfejs API wystąpień obsługuje następujące operacje:
  • Wyszukiwanie: pobiera częściową listę trafień na potrzeby wyszukiwania wystąpień szeregów czasowych na podstawie atrybutów wystąpienia.
  • Sugerowanie: wyszukuje i sugeruje częściową listę wyników w wyszukiwaniu instancji szeregów czasowych w oparciu o atrybuty instancji.

Interfejsy API dla zapytań do szeregów czasowych (TSQ)

Te interfejsy API są dostępne w obu warstwach (ciepłej i zimnej) w naszym wielowarstwowym rozwiązaniu magazynowania.

• Get Events API: Umożliwia wykonywanie zapytań i pobieranie surowych zdarzeń oraz skojarzonych sygnatur czasowych zdarzeń, gdy są one rejestrowane w usłudze Azure Time Series Insights Gen2 przez dostawcę ź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 spłaszczeniu i usuwaniu reguł JSON tablice będą przechowywane jako typ dynamiczny . Właściwości ładunku przechowywane jako ten typ są dostępne tylko za pośrednictwem interfejsu API Get Events.

• Interfejs API uzyskiwania serii danych: umożliwia wykonywanie zapytań i pobieranie obliczonych wartości oraz skojarzonych znaczników czasowych zdarzeń poprzez zastosowanie obliczeń zdefiniowanych za pomocą zmiennych do surowych 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 związanych z nimi znaczników czasowych interwałów poprzez stosowanie obliczeń, które są zdefiniowane przez zmienne, na surowych zdarzeniach. 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.

  W przypadku określonego zakresu wyszukiwania i interwału ten interfejs API zwraca zagregowaną odpowiedź na każdy interwał dla każdej zmiennej szeregu czasowego. Liczba interwałów w zestawie danych odpowiedzi jest obliczana przez zliczanie znaczników epok (liczba milisekund, które upłynęły od epoki systemu Unix — 1 stycznia 1970 r.) i podzielenie znaczników epok przez rozpiętość interwału określoną w zapytaniu.

  Znaczniki czasu zwracane w odpowiedzi to lewe granice interwału, a nie próbki zdarzeń z interwału.

Wybieranie typu magazynu

Powyższe interfejsy API mogą być wykonane tylko dla jednego z dwóch typów pamięci masowej (zimny lub ciepły) w jednym wywołaniu. Parametry adresu URL zapytania służą do określania typu magazynu , na którym ma być wykonywane zapytanie.

Jeśli nie zostanie określony żaden parametr, zapytanie zostanie domyślnie wykonane na Cold Store. Jeśli zapytanie obejmuje zakres czasu, który nakłada się zarówno na pamięć zimną, jak i ciepłą, zaleca się kierowanie zapytania do pamięci zimnej dla uzyskania najlepszego efektu, ponieważ pamięć ciepła będzie zawierać tylko częściowe dane.

Eksplorator usługi 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 jest to istotne.

Następne kroki

• Przeczytaj więcej na temat różnych zmiennych, które można zdefiniować w modelu szeregów czasowych.
• Dowiedz się więcej na temat wykonywania zapytań o dane z eksploratora usługi Azure Time Series Insights.