지원되는 데이터 형식
메모
Time Series Insights 서비스는 2024년 7월 7일에 사용 중지됩니다. 가능한 한 빨리 기존 환경을 대체 솔루션으로 마이그레이션하는 것이 좋습니다. 사용 중단 및 마이그레이션에 대한 자세한 내용은 설명서를 참조하세요.
다음 표에서는 Azure Time Series Insights Gen2에서 지원하는 데이터 형식을 나열합니다.
| 데이터 형식 | 묘사 | 예시 | 시계열 식 구문 | Parquet 파일의 속성 열 이름 |
|---|---|---|---|---|
| 부울 |
true 또는 false두 가지 상태 중 하나를 갖는 데이터 형식입니다. |
"isQuestionable" : true |
$event.isQuestionable.Bool 또는 $event['isQuestionable'].Bool |
isQuestionable_bool |
| 날짜/시간 | 일반적으로 날짜 및 시간으로 표현되는 인스턴트 시간을 나타냅니다.
ISO 8601 형식으로 표현됩니다. 날짜/시간 속성은 항상 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 |
| 동적 | 배열 또는 속성 모음(사전)으로 구성된 복합(기본 형식이 아닌) 형식입니다. 현재는 TS ID 또는 타임스탬프 속성(ies)을 포함하지 않는 기본 형식의 문자열화된 JSON 배열 또는 개체 배열만 동적으로 저장됩니다. 개체를 평면화하고 배열을 언롤하는 방법을 이해하려면 이 문서를 읽어보세요. 이 형식으로 저장된 페이로드 속성은 원시 이벤트를 보기 위해 Time Series Insights 탐색기에서 Explore Events 선택하거나 클라이언트 쪽 구문 분석용 GetEvents 쿼리 API를 통해서만 액세스할 수 있습니다. |
"values": "[197, 194, 189, 188]" |
시계열 식에서 동적 형식 참조는 아직 지원되지 않습니다. | values_dynamic |
메모
64비트 정수 값이 지원되지만 JavaScript 제한으로 인해 Azure Time Series Insights Explorer에서 안전하게 표현할 수 있는 가장 큰 수는 9,007,199,254,740,991(2^53-1)입니다. 위의 데이터 모델에서 숫자로 작업하는 경우
메모
String 형식은 null을 허용하지 않습니다.
-
시계열 쿼리에서 표현된 TSX(시계열 식)은 빈 문자열('')과 NULL을 비교할 때 동일하게 동작하며,
$event.siteid.String = NULL$event.siteid.String = ''와 동일합니다. - 원래 이벤트에 빈 문자열이 포함된 경우에도 API는 NULL 값을 반환할 수 있습니다.
- String 열의 NULL 값에 종속되지 않고 비교 또는 평가를 수행하여 빈 문자열과 동일한 방식으로 처리합니다.
혼합 데이터 형식 보내기
Azure Time Series Insights Gen2 환경은 강력한 형식입니다. 디바이스 또는 태그가 디바이스 속성에 대해 서로 다른 형식의 데이터를 보내는 경우 값은 두 개의 구분된 열에 저장되고 API 호출에서 시계열 모델 변수 식을 정의할 때 coalesce() 함수 사용해야 합니다.
Azure Time Series Insights 탐색기는 동일한 디바이스 속성의 별도 열을 자동으로 병합하는 방법을 제공합니다. 아래 예제에서 센서는 Long 또는 Double일 수 있는 PresentValue 속성을 보냅니다.
PresentValue 속성의 저장된 모든 값(데이터 형식에 관계없이)에 대해 쿼리하려면 PresentValue (Double | Long) 선택하면 열이 병합됩니다.
개체 및 배열
이벤트 페이로드의 일부로 개체 및 배열과 같은 복합 형식을 보낼 수 있습니다. 중첩된 개체는 평면화되고, 배열은 환경 구성 및 JSON 형태에 따라 dynamic로 저장되거나, 평면화되어 여러 이벤트를 생성합니다.
JSON 평면화 및 이스케이프 규칙에 대해 더 알아보시려면