Yeni ortamlar için JSON düzlük ve kaçış kurallarında yapılacak değişiklikler

Önemli

Bu değişiklikler yeni oluşturulan Microsoft Azure Time Series Insights 2. Nesil ortamlara uygulanır. Değişiklikler 1. Nesil ortamları için geçerli değildir.

Azure Time Series Insights 2. Nesil ortamınız, belirli bir adlandırma kuralları kümesine göre depolama sütunlarınızı dinamik olarak oluşturur. Bir olay geldiğinde, Time Series Insights JSON yüküne ve özellik adlara bir kural kümesi uygular. Temmuz 2020'de JSON verilerini düzlükte ve depolana Azure Time Series Insights 2. Nesil ortamlarında yapılan değişiklikler etkili oldu. Bu değişiklik aşağıdaki durumlarda sizi etkiler:

  • JSON yükünüz iç içe nesneler içeriyor.
  • JSON yükünüz diziler içerir.
  • Bir JSON özellik adı içinde aşağıdaki dört özel karakterden birini kullanırsiniz: [ \ .``'
  • Zaman Serisi (TS) kimlik özelliklerinizin biri veya daha fazlası iç içe geçmiş bir nesne içindedir.

Yeni bir ortam oluşturmanız ve bu durumlardan biri veya daha fazlası olay yükünüz için geçerli olursa, verileriniz düz hale gelecek ve farklı bir şekilde depolanmış olur. Aşağıdaki tabloda değişiklikler özetlenmiştir:

Geçerli kural Yeni kural Örnek JSON Önceki sütun adı Yeni sütun adı
İç içe JSON, çizgileyici olarak bir alt çizgi kullanılarak düzdür. İç içe JSON, bir noktanın satır çizgisi olarak kullanılarak düzdür. {"series" : { "value" : 19.338 }} series_value_double series.value_double
Özel karakterlere kaçlanmaz. Özel karakterleri içeren ve ve kullanılarak kaçan JSON . [\ ' özellik [' '] adları. ['ve '] içinde, tek tırnak ve yazı tipi ek kaçışlar vardır. Tek bir tırnak olarak yazılır ve \' olarak ters eğik çizgi \\ yazılır. "Foo's Law Value": "17.139999389648" Foo's Law Value_double ['Foo\'s Law Value']_double
Temel öğe dizileri dize olarak depolanır. İlkel tür dizileri dinamik tür olarak depolanır. "values": [154, 149, 147] values_string values_dynamic
Nesne dizileri her zaman düzdür ve birden çok olay oluşturur. Bir dizideki nesnelerin TS KIMLIĞI veya zaman damgası özellikleri yoksa, nesne dizisi dinamik tür olarak tam olarak depolanır. "values": [{"foo" : 140}, {"bar" : 149}] values_foo_long | values_bar_long values_dynamic

TS KIMLIĞINIz ve/veya zaman damgası özelliğiniz bir nesne içinde iç içe geçmişse

Tüm yeni dağıtımların yeni alımı kurallarıyla eşleşmesi gerekir. Örneğin, TS Kimliğiniz ise, ortam TS KIMLIĞI olarak yapılandırmak için Azure Resource Manager şablonlarını veya otomatik dağıtım telemetry_tagId telemetry.tagId betiklerini güncelleştirmeniz gerekir. İç içe geçmiş JSON'da olay kaynağı zaman damgası için de bu değişikliğin olması gerekir.

Yükünüz iç içe JSON veya özel karakterler içeriyorsa ve Time Series Model değişken ifadeleri yazma işlemini otomatikleştirin

TypesBatchPut yürüten istemci kodunuzu yeni veri alımı kurallarıyla eş olacak şekilde güncelleştirin. Örneğin, önceki bir Zaman Serisi İfadesini aşağıdaki seçeneklerden "value": {"tsx": "$event.series_value.Double"} biri ile güncelleştirmeniz gerekir:

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

Sonraki adımlar