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

В этой статье приводятся основные сведения об этом языке запросов и его возможностях. Напомним, что основой Azure Digital Twins является граф двойников, который состоит из цифровых двойников и связей между ними. К этому графу можно отправлять запросы, чтобы получить информацию о содержащихся в нем цифровых двойниках и связях. Для написания таких запросов используется пользовательский язык запросов, схожий с SQL, который называется язык запросов 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'
  

• Если вы используете Azure CLI для выполнения запросов, может потребоваться избежать определенных дополнительных символов в соответствии с требованиями различных оболочк. Дополнительные сведения см. в разделе "Использование специальных символов в разных оболочках"

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

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

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

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

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