다음을 통해 공유

새 환경에 대한 JSON 평면화 및 이스케이프 규칙의 향후 변경 내용

  • 아티클

메모

Time Series Insights 서비스는 2024년 7월 7일에 사용 중지됩니다. 가능한 한 빨리 기존 환경을 대체 솔루션으로 마이그레이션하는 것이 좋습니다. 사용 중단 및 마이그레이션에 대한 자세한 내용은 문서를 참조하세요.

중요하다

이러한 변경 사항은 새로 만든 Microsoft Azure Time Series Insights Gen2 환경에만 적용됩니다. 변경 내용은 Gen1 환경에 적용되지 않습니다.

Azure Time Series Insights Gen2 환경은 특정 명명 규칙 집합에 따라 스토리지 열을 동적으로 만듭니다. 이벤트가 수집되면 Time Series Insights는 JSON 페이로드 및 속성 이름에 규칙 집합을 적용합니다. 2020년 7월에 새로운 Azure Time Series Insights Gen2 환경에 JSON 데이터를 평면화하고 저장하는 방법에 대한 변경 내용이 적용되었습니다. 이 변경 내용은 다음과 같은 경우에 영향을 줍니다.

  • JSON 페이로드에는 중첩된 개체가 포함됩니다.
  • JSON 페이로드에 배열이 포함되어 있습니다.
  • JSON 속성 이름에 다음 네 개의 특수 문자 중에서 사용할 수 있습니다. [\.'
  • 하나 이상의 시간 시리즈(ID) 속성이 중첩된 객체 안에 포함되어 있습니다.

새 환경을 만들고 이러한 사례 중 하나 이상이 이벤트 페이로드에 적용되는 경우 데이터는 평면화되고 다르게 저장됩니다. 다음 표에서는 변경 내용을 요약합니다.

현재 규칙 새 규칙 예제 JSON 이전 열 이름 새 열 이름
중첩된 JSON은 밑줄을 설명자로 사용하여 평면화됩니다. 중첩된 JSON은 마침표를 사용하여 평탄화됩니다. {"series" : { "value" : 19.338 }} series_value_double series.value_double
특수 문자는 이스케이프되지 않습니다. 특수 문자 .,[,\ 및 '을 포함하는 JSON 속성 이름은 [' 및 ']로 이스케이프됩니다. [' 및 ']내에서 작은따옴표와 백슬라이시의 추가 이스케이프가 있습니다. 작은따옴표 기호는 \'로, 백슬래시 기호는 \\로 표기됩니다. "Foo's Law Value": "17.139999389648" Foo's Law Value_double ['Foo\'s Law Value']_double
기본 형식의 배열은 문자열로 저장됩니다. 기본 형식의 배열은 동적 형식으로 저장됩니다. "values": [154, 149, 147] values_string values_dynamic
개체의 배열은 항상 평면화되어 여러 이벤트를 생성합니다. 배열 내의 개체에 TS ID 또는 타임스탬프 속성이 없으면 개체 배열이 동적 형식으로 전체 저장됩니다. "values": [{"foo" : 140}, {"bar" : 149}] values_foo_long | values_bar_long values_dynamic

TS ID 및/또는 타임스탬프 속성이 개체 내에 중첩된 경우

모든 새 배포는 새 데이터 수집 규칙과 일치해야 합니다. 예를 들어 TS ID가 telemetry_tagId경우 Azure Resource Manager 템플릿 또는 자동화된 배포 스크립트를 업데이트하여 telemetry.tagId 환경 TS ID로 구성해야 합니다. 또한 중첩된 JSON의 이벤트 원본 타임스탬프에 대해 이 변경이 필요합니다.

페이로드에 중첩된 JSON 또는 특수 문자가 포함되어 있으며, 시계열 모델 변수 식의 작성을 자동화하는 경우

TypesBatchPut을 실행하는 클라이언트 코드를 새로운 입력 규칙에 맞게 업데이트합니다. 예를 들어 "value": {"tsx": "$event.series_value.Double"} 이전 시계열 식 다음 옵션 중 하나로 업데이트해야 합니다.

  • "value": {"tsx": "$event.series.value.Double"}
  • "value": {"tsx": "$event['series']['value'].Double"}

다음 단계

  • Azure Time Series Insights Gen2 스토리지 및 수신대해 알아봅니다.

  • 시계열 쿼리 API사용하여 데이터를 쿼리하는 방법을 알아봅니다.

  • 새 시계열 식 구문대해 자세히 알아보세요.