wtyczka azure_digital_twins_query_request

Wtyczka azure_digital_twins_query_request uruchamia zapytanie usługi Azure Digital Twins w ramach zapytania język zapytań Kusto (KQL). Wtyczka jest wywoływana z operatorem evaluate .

Za pomocą wtyczki można wykonywać zapytania dotyczące danych zarówno w usłudze Azure Digital Twins, jak i w dowolnym źródle danych dostępnym za pośrednictwem języka KQL. Na przykład można wykonywać analizy szeregów czasowych.

Aby uzyskać więcej informacji na temat wtyczki, zobacz Wtyczka zapytań usługi Azure Digital Twins dla usługi Azure Data Explorer.

Składnia

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa	Typ	Wymagane	Opis
AdtInstanceEndpoint	string	✔️	Punkt końcowy wystąpienia usługi Azure Digital Twins do odpytowania.
AdtQuery	string	✔️	Zapytanie uruchamiane względem punktu końcowego usługi Azure Digital Twins. To zapytanie jest pisane w niestandardowym języku zapytań przypominającym sql dla usługi Azure Digital Twins nazywanym językiem zapytań usługi Azure Digital Twins. Aby uzyskać więcej informacji, zobacz Język zapytań dla usługi Azure Digital Twins.

Uwierzytelnianie i autoryzacja

Wtyczka azure_digital_twins_query_request używa konta Microsoft Entra użytkownika uruchamiającego zapytanie w celu uwierzytelnienia. Aby uruchomić zapytanie, użytkownik musi mieć co najmniej przypisaną rolę Czytelnik danych usługi Azure Digital Twins . Informacje na temat przypisywania tej roli można znaleźć w temacie Security for Azure Digital Twins solutions (Zabezpieczenia dla rozwiązań usługi Azure Digital Twins).

Przykłady

W poniższych przykładach pokazano, jak można uruchamiać różne zapytania usługi Azure Digital Twins, w tym zapytania korzystające z dodatkowych wyrażeń Kusto.

Pobieranie wszystkich reprezentacji bliźniaczych w wystąpieniu usługi Azure Digital Twins

Poniższy przykład zwraca wszystkie cyfrowe reprezentacje bliźniacze w wystąpieniu usługi Azure Digital Twins.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T AS Twins FROM DIGITALTWINS T')

Projekcja właściwości bliźniaczych reprezentacji jako kolumn wraz z dodatkowymi wyrażeniami Kusto

Poniższy przykład zwraca wynik z wtyczki jako oddzielne kolumny, a następnie wykonuje dodatkowe operacje przy użyciu wyrażeń Kusto.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T.Temperature, T.Humidity FROM DIGITALTWINS T WHERE IS_PRIMITIVE(T.Temperature) AND IS_PRIMITIVE(T.Humidity)')
| where Temperature > 20
| project TemperatureInC = Temperature, Humidity

Dane wyjściowe

TemperatureInC	Wilgotność
21	48
49	34
80	32

Wykonywanie analizy szeregów czasowych

Funkcja integracji historii danych usługi Azure Digital Twins umożliwia historizowanie aktualizacji właściwości cyfrowej reprezentacji bliźniaczej. Aby dowiedzieć się, jak wyświetlać historięzowane aktualizacje bliźniaczej reprezentacji, zobacz Wyświetlanie historiazowanych aktualizacji bliźniaczych reprezentacji w usłudze Azure Data Explorer