Udostępnij przez

wtyczka azure_digital_twins_query_request

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

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ć analizę szeregów czasowych.

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

Składnia

evaluate azure_digital_twins_query_request ( AdtInstanceEndpoint,AdtQuery)

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Typ Wymagania 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 napisane 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

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')

Zrzut ekranu przedstawiający reprezentacje bliźniacze obecne w wystąpieniu usługi Azure Digital Twins.

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

Wyjście

TemperatureInC Wilgotność
dwadzieścia jeden 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świetlić historięzed aktualizacje bliźniaczej reprezentacji, zobacz Wyświetlanie historii aktualizacji bliźniaczych reprezentacji bliźniaczych

  • Last updated on