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

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

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

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

Синтаксис

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

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

Параметры

Имя	Тип	Обязательно	Описание
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')

Проекция свойств двойника в виде столбцов вместе с дополнительными выражениями 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 для создания журналов обновлений свойств цифровых двойников. Сведения о просмотре обновлений с помощью журнала двойников см. в статье Просмотр обновлений с помощью журнализованных двойников в Azure Data Explorer