Язык запросов Azure Digital Twins

В этой статье приводятся основные сведения об этом языке запросов и его возможностях. Напомним, что основой Azure Digital Twins является граф двойников, который состоит из цифровых двойников и связей между ними. К этому графу можно отправлять запросы, чтобы получить информацию о содержащихся в нем цифровых двойниках и связях. Для написания таких запросов используется пользовательский язык запросов, схожий с SQL, который называется язык запросов Azure Digital Twins. Этот язык похож на язык запросов Центра Интернета вещей и имеет много схожих с ним возможностей.

Более подробные примеры синтаксиса запросов и инструкции по их выполнению см. в статье Запрос данных о графе двойника Azure Digital Twins.

Сведения о запросах

С помощью языка запросов Azure Digital Twins вы можете получать цифровые двойники, используя следующие их аспекты:

• Свойства (включая свойства тега)
• Модели
• Отношения
  • Свойства связей

Чтобы отправить запрос к службе из клиентского приложения, используйте API запросов Azure Digital Twins. Помимо прочего, использовать этот API можно посредством одного из пакетов SDK для Azure Digital Twins.

Справочная документация

Справочные материалы по языку запросов можно найти в разделе Справочные материалы в левой части раздела с документацией по Azure Digital Twins. Вы также можете перейти непосредственно к справочным разделам, используя приведенные ниже ссылки:

• Предложения
  • SELECT
  • FROM
  • MATCH
  • JOIN
  • WHERE
• Функции
• Операторы
• Зарезервированные слова

Рекомендации по работе с запросами

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

• Учитывайте регистр символов. Во всех операциях запросов Azure Digital Twins учитывается регистр символов, поэтому следует использовать любые имена в том виде, в котором они определены в моделях. Если имена свойств написаны некорректно или имеют неправильный регистр, будет возвращен пустой результирующий набор без каких-либо ошибок.

• Экранирование одинарных кавычек. Если текст запроса содержит одинарную кавычку, такие кавычки необходимо экранировать с помощью символа \. Ниже приведен пример, в котором используется значение свойства D'Souza:

  SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
  

Примечание

После внесения изменений в данные в графе может возникнуть задержка до 10 секунд, прежде чем изменения будут отражены в запросах.

API DigitalTwins отражает изменения немедленно, поэтому, если вам нужен мгновенный ответ, используйте запрос API (DigitalTwins GetById) или вызов пакета SDK (GetDigitalTwin) для получения данных двойника вместо запроса.

Запрос данных историзированного двойника с течением времени

Язык запросов Azure Digital Twins предназначен только для запроса текущего состояния цифровых двойников и связей.

Чтобы выполнять запросы к журнализованным данным графа двойников, собранным с течением времени, используйте функцию журнала данных для подключения экземпляра Azure Digital Twins к кластеру Azure Data Explorer. Это автоматически будет выполнять журнал обновлений графов в Data Explorer Azure, где их можно запросить с помощью подключаемого модуля Azure Digital Twins для Azure Data Explorer.

Следующие шаги

Сведения о том, как создавать запросы, а также примеры клиентского кода вы найдете в статье Запрос данных о графе двойника Azure Digital Twins.