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.
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
Olayların nasıl depolandığını anlamak için JSON düzleştirme ve kaçış kurallarını okuyun.
Ortamınızın aktarım hızı sınırlamalarını anlama
Akış verilerini almak için olay kaynakları hakkında bilgi edinin.