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

Поддерживаемые типы данных

  • Статья

Заметка

Служба "Аналитика временных рядов" будет прекращена 7 июля 2024 года. Рассмотрите возможность переноса существующих сред в альтернативные решения как можно скорее. Дополнительные сведения о выводе из эксплуатации и миграции см. в нашей документации .

В следующей таблице перечислены типы данных, поддерживаемые Аналитикой временных рядов Azure 2-го поколения.

Тип данных Описание Пример синтаксис выражения временного ряда Имя столбца свойств в Parquet
bool Тип данных с одним из двух состояний: true или false. "isQuestionable" : true $event.isQuestionable.Bool или $event['isQuestionable'].Bool isQuestionable_bool
дата и время Представляет момент времени, который обычно выражается как дата и время дня. Выражено в формате ISO 8601. Свойства datetime всегда хранятся в формате UTC. Смещения часовых поясов, если они правильно отформатированы, будут применены, после чего значения будут сохранены в формате UTC. Дополнительные сведения о свойстве метки времени среды и смещениях даты и времени см. в этом разделе . "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" Если eventProcessedLocalTime — это метка времени источника события: $event.$ts. Если это другое свойство JSON: $event.eventProcessedLocalTime.DateTime или $event['eventProcessedLocalTime'].DateTime eventProcessedLocalTime_datetime
двойной 64-разрядное число двойной точности "value": 31.0482941 $event.value.Double или $event['value'].Double value_double
длинные 64-разрядное целое число со знаком "value" : 31 $event.value.Long или $event['value'].Long value_long
строка Текстовые значения должны состоять из допустимых значений UTF-8. Значения NULL и пустые строки обрабатываются одинаково. "site": "DIM_MLGGG" $event.site.String или $event['site'].String site_string
динамические Сложный (немитивный) тип, состоящий из массива или контейнера свойств (словаря). В настоящее время только строковые представления массивов JSON примитивных типов данных или массивов объектов, не содержащие идентификатор TS или свойство метки времени, будут храниться как динамические. Ознакомьтесь с этой статьёй , чтобы понять, как объекты будут сплющены, а массивы могут быть развёрнуты. Свойства полезных данных, хранящиеся в этом типе, доступны только путем выбора Explore Events в обозревателе аналитики временных рядов для просмотра необработанных событий или с помощью API запросов GetEvents для анализа на стороне клиента. "values": "[197, 194, 189, 188]" Ссылка на динамические типы в выражении временных рядов пока не поддерживается values_dynamic

Заметка

Поддерживаются 64-разрядные целые значения, но наибольшее число, которое обозреватель аналитики временных рядов Azure может безопасно выразить, составляет 9 007 199 254 740 991 (2^53-1) из-за ограничений JavaScript. Если вы работаете с числами в модели данных, поэтому можно уменьшить размер, создав переменную модели временных рядов и преобразовав значение.

Заметка

строковый тип не допускает значение NULL:

  • Выражение временных рядов (TSX), представленное в запросе временных рядов, сравнивающем значение пустой строки ('') с NULL, будет вести себя аналогично: $event.siteid.String = NULL соответствует $event.siteid.String = ''.
  • API может возвращать значения NULL, даже если в исходных событиях содержались пустые строки.
  • Не используйте зависимость от значений NULL в столбцах String, чтобы выполнять сравнения или оценки, обрабатывать их так же, как пустые строки.

Отправка смешанных типов данных

Среда Аналитики временных рядов Azure 2-го поколения строго типизирована. Если устройства или теги отправляют данные разных типов для свойства устройства, значения будут храниться в двух отдельных столбцах, и при определении выражений переменных модели временного ряда в вызовах API следует использовать функцию coalesce().

Обозреватель Azure Time Series Insights позволяет автоматически объединять отдельные столбцы одного и того же свойства устройства. В приведенном ниже примере датчик отправляет свойство PresentValue, которое может быть как длинным, так и двойным. Чтобы запросить все сохраненные значения (независимо от типа данных) свойства PresentValue, выберите PresentValue (Double | Long), а столбцы будут объединяться.

автоматическое объединение обозревателя

Объекты и массивы

Вы можете отправлять сложные типы, такие как объекты и массивы, в составе полезных данных события. Вложенные объекты будут упрощены, а массивы будут либо храниться в виде dynamic, либо преобразованы для создания нескольких событий в зависимости от конфигурации среды и структуры JSON. Дополнительные сведения о правилах упрощения и экранирования JSON и

Дальнейшие действия