Udostępnij za pośrednictwem

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

  • Artykuł

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

Usługa 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 TSI usługi Azure Time Series Insights.

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 usługi 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 zapytań modelu 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ń 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.

Omówienie zapytania szeregów czasowych

Interfejsy 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ń w sygnaturze $tsczasowej zdarzenia . Ten interfejs API pomaga określić, czy w środowisku istnieją jakiekolwiek zdarzenia, zwracając liczbę zdarzeń podzielonych na interwały czasu, jeśli istnieją.
  • Pobierz interfejs 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.

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

Większość z tych interfejsów API obsługuje operacje wykonywania wsadowego, aby umożliwić wykonywanie operacji CRUD wsadowych w wielu jednostkach 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ę trafień w wyszukiwaniu 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 sklepach (ciepły i zimny) w naszym wielowarstwowym rozwiązaniu magazynu.

  • Interfejs API pobierania zdarzeń: umożliwia wykonywanie zapytań i pobieranie nieprzetworzonych zdarzeń oraz skojarzonych sygnatur czasowych zdarzeń podczas rejestrowania ich 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 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 pobierania zdarzeń.

  • Uzyskiwanie interfejsu API 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 w nieprzetworzonych 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 interwał dla zmiennej 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 podzielenie znaczników według rozmiaru przedziału interwału określonego w zapytaniu.

    Znaczniki czasu zwracane w zestawie odpowiedzi to granice interwału po lewej stronie, a nie z przykładowych zdarzeń z interwału.

Wybieranie typu magazynu

Powyższe interfejsy API mogą być wykonywane tylko względem jednego z dwóch typów magazynów (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 określono parametru, 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ż magazyn ciepły 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.