Подключаемый модуль azure_digital_twins_query_request

Статья
11/23/2024

Область применения: ✅Microsoft Fabric ✅Azure Data Explorer

Подключаемый azure_digital_twins_query_request модуль запускает запрос Azure Digital Twins в рамках запроса язык запросов Kusto (KQL). Подключаемый модуль вызывается оператором evaluate .

С помощью подключаемого модуля можно запрашивать данные как в Azure Digital Twins, так и в любом источнике данных, доступном через KQL. Например, можно выполнять аналитику временных рядов.

Дополнительные сведения о подключаемом модуле см . в подключаемом модуле запросов Azure Digital Twins.

Синтаксис

evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название)	Type	Обязательно	Описание
AdtInstanceEndpoint	`string`	✔️	Конечная точка экземпляра Azure Digital Twins для запроса.
AdtQuery	`string`	✔️	Запрос для выполнения в конечной точке Azure Digital Twins. Этот запрос написан на пользовательском языке запросов, например SQL для Azure Digital Twins, который называется языком запросов Azure Digital Twins. Дополнительные сведения см. в разделе "Язык запросов" для Azure Digital Twins.

Проверка подлинности и авторизация

Подключаемый azure_digital_twins_query_request модуль использует учетную запись Microsoft Entra пользователя, выполняющего запрос, для проверки подлинности. Чтобы выполнить запрос, пользователю должна быть предоставлена по крайней мере роль чтения данных Azure Digital Twins. Сведения о назначении этой роли см. в статье Безопасность для решений Azure Digital Twins.

Примеры

В следующих примерах показано, как выполнять различные запросы Azure Digital Twins, включая запросы, использующие дополнительные выражения Kusto.

Получение всех двойников в экземпляре Azure Digital Twins

В следующем примере возвращаются все цифровые двойники в экземпляре Azure Digital Twins.

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

Снимок экрана: двойники, присутствующие в экземпляре Azure Digital Twins.

Проекция свойств двойника в виде столбцов вместе с дополнительными выражениями Kusto

В следующем примере результат из подключаемого модуля возвращается в виде отдельных столбцов, а затем выполняет дополнительные операции с помощью выражений 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

Выходные данные

TemperatureInC	Влажность
21	48
49	34
80	32

Анализ временных рядов

Вы можете использовать функцию интеграции журнала данных Azure Digital Twins для анализа обновлений свойств цифрового двойника. Сведения о просмотре журнализованных обновлений двойника см. в разделе " Просмотр журнализованных обновлений двойника"

Поделиться через