Desteklenen veri türleri

Not

Time Series Insights (TSI) hizmeti artık Mart 2025'e kadar desteklenmeyecektir. Mevcut TSI ortamlarını mümkün olan en kısa sürede alternatif çözümlere geçirmeyi göz önünde bulundurun. Kullanımdan kaldırma ve geçiş hakkında daha fazla bilgi için belgelerimizi ziyaret edin.

Aşağıdaki tabloda Azure Time Series Insights 2. Nesil tarafından desteklenen veri türleri listelenmektedir

Veri türü Açıklama Örnek Zaman Serisi İfadesi söz dizimi Parquet'te özellik sütun adı
bool İki durumdan birine sahip bir veri türü: true veya false. "isQuestionable" : true $event.isQuestionable.Bool veya $event['isQuestionable'].Bool isQuestionable_bool
Datetime Genellikle günün tarih ve saati olarak ifade edilen bir anlık zamanı temsil eder. ISO 8601 biçiminde ifade edilir. Datetime özellikleri her zaman UTC biçiminde depolanır. Doğru biçimlendirilmişse saat dilimi uzaklıkları uygulanır ve utc olarak depolanır. Ortam zaman damgası özelliği ve tarih saat uzaklıkları hakkında daha fazla bilgi için bu bölüme bakın "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" Olay kaynağı zaman damgası "eventProcessedLocalTime" ise: $event.$ts. Başka bir JSON özelliğiyse: $event.eventProcessedLocalTime.DateTime veya $event['eventProcessedLocalTime'].DateTime eventProcessedLocalTime_datetime
double Çift duyarlıklı 64 bit sayı "value": 31.0482941 $event.value.Double veya $event['value'].Double value_double
long İşaretli 64 bit tamsayı "value" : 31 $event.value.Long veya $event['value'].Long value_long
Dize Metin değerleri geçerli UTF-8'i içermelidir. Null ve boş dizeler aynı şekilde değerlendirilir. "site": "DIM_MLGGG" $event.site.String veya $event['site'].String site_string
Dinamik Dizi veya özellik paketinden (sözlük) oluşan karmaşık (ilkel olmayan) tür. Şu anda yalnızca TS Kimliğini veya zaman damgası özelliğini (ies) içermeyen temel öğe veya nesne dizilerinden oluşan dizeli JSON dizileri dinamik olarak depolanır. Nesnelerin nasıl düzleştirilmiş olacağını ve dizilerin nasıl silinebileceğini anlamak için bu makaleyi okuyun. Bu tür olarak depolanan yük özelliklerine yalnızca Ham olayları görüntülemek için Time Series Insights Gezgini'ni seçerek Explore Events veya istemci tarafı ayrıştırma için Sorgu API'sini kullanarak GetEvents erişilebilir. "values": "[197, 194, 189, 188]" Zaman Serisi İfadesinde dinamik türlere başvuruda bulunmak henüz desteklenmiyor values_dynamic

Not

64 bit tamsayı değerleri desteklenir, ancak JavaScript sınırlamaları nedeniyle Azure Time Series Insights Gezgini'nin güvenle ifade edebilecekleri en büyük sayı 9.007.199.254.740.991 'dir (2^53-1). Bunun üzerinde veri modelinizdeki sayılarla çalışıyorsanız, bir Zaman Serisi Modeli değişkeni oluşturup değeri dönüştürerek boyutu küçültebilirsiniz.

Not

Dize türü null değer atanamaz:

  • Boş bir dizenin ('') değerini NULL ile karşılaştıran Bir Zaman Serisi Sorgusunda ifade edilen Zaman Serisiİfadesi (TSX) aynı şekilde davranır:$event.siteid.String = NULL ile $event.siteid.String = ''eşdeğerdir.
  • Özgün olaylar boş dizeler içerse bile API NULL değerler döndürebilir.
  • Karşılaştırmalar veya değerlendirmeler yapmak için Dize sütunlarındaki NULL değerlere bağımlılık almayın, bunları boş dizelerle aynı şekilde değerlendirin.

Karma veri türleri gönderme

Azure Time Series Insights 2. Nesil ortamınız kesin olarak yazıldı. Cihazlar veya etiketler bir cihaz özelliği için farklı türde veriler gönderiyorsa, değerler iki ayrı sütunda depolanır ve API çağrılarında Zaman Serisi Model Değişkeni ifadelerinizi tanımlarken coalesce() işlevi kullanılmalıdır.

Azure Time Series Insights Gezgini, aynı cihaz özelliğinin ayrı sütunlarını otomatik olarak birleştirmenin bir yolunu sunar. Aşağıdaki örnekte, algılayıcı hem Uzun hem de Çift olabilecek bir PresentValue özellik gönderir. Özelliğin tüm depolanan değerlerini (veri türünden bağımsız olarak) PresentValue sorgulamak için öğesini seçin PresentValue (Double | Long) ; sütunlar sizin için birleştirir.

Explorer otomatik birleştirme

Nesneler ve diziler

Olay yükünüzün bir parçası olarak nesneler ve diziler gibi karmaşık türler gönderebilirsiniz. İç içe nesneler düzleştirilebilir ve ortam yapılandırmanıza ve JSON şeklinize bağlı olarak birden çok olay üretmek için diziler olarak dynamic depolanır veya düzleştirilebilir. JSON Düzleştirme ve Kaçış Kuralları hakkında daha fazla bilgi edinmek için

Sonraki adımlar