Azure Time Series Insights 2. Nesil'deki Verileri Sorgulama
Not
Time Series Insights hizmeti 7 Temmuz 2024'te kullanımdan kaldırılacaktır. Mevcut ortamları 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.
Azure Time Series Insights 2. Nesil, genel yüzey API'leri aracılığıyla ortamda depolanan olaylar ve meta veriler üzerinde veri sorgulamaya olanak tanır. Bu API'ler Azure Time Series Insights TSI Gezgini tarafından da kullanılır.
Azure Time Series Insights 2. Nesil'de üç birincil API kategorisi mevcuttur:
- Ortam API'leri: Bu API'ler Azure Time Series Insights 2. Nesil ortamında sorguları etkinleştirir. Bunlar, çağıranın erişimi olan ortamların listesini ve ortam meta verilerini toplamak için kullanılabilir.
- Time Series Model-Query (TSM-Q) API'leri: Ortamın Zaman Serisi Modeli'nde depolanan meta verilerde oluşturma, okuma, güncelleştirme ve silme (CRUD) işlemlerini etkinleştirir. Bunlar örneklere, türlere ve hiyerarşilere erişmek ve bunları düzenlemek için kullanılabilir.
- Zaman Serisi Sorgusu (TSQ) API'leri: Telemetri veya olay verilerinin kaynak sağlayıcıdan kaydedildiği şekilde alınmasını sağlar ve gelişmiş skaler ve toplama işlevlerini kullanarak veriler üzerinde performanslı hesaplamalar ve toplamalar sağlar.
Azure Time Series Insights 2. Nesil, Zaman Serisi Değişkenleri'nde hesaplamaları ifade etmek için zengin dize tabanlı ifade dili time series expression (TSX) kullanır.
Azure Time Series Insights 2. Nesil API'lerine genel bakış
Aşağıdaki temel API'ler desteklenir.
Ortam API'leri
- Ortamları Alma API'si: Çağıranın erişim yetkisine sahip olduğu ortamların listesini döndürür.
- Ortamların Kullanılabilirlik API'sini alma: Olay zaman damgası
$tsüzerinden olay sayısının dağılımını döndürür. Bu API, varsa zaman aralıklarına ayrılmış olayların sayısını döndürerek ortamda herhangi bir olay olup olmadığını belirlemeye yardımcı olur. - Olay Şeması API'sini alma: Belirli bir arama aralığı için olay şeması meta verilerini döndürür. Bu API, verilen arama aralığı için şemada bulunan tüm meta verileri ve özellikleri almaya yardımcı olur.
Zaman Serisi Model Sorgusu (TSM-Q) API'leri
Bu API'lerin çoğu, birden çok Zaman Serisi Modeli varlığında toplu CRUD işlemlerini etkinleştirmek için toplu yürütme işlemini destekler:
- Model Ayarları API'si: Varsayılan türde ve ortamın model adında GET ve PATCH'i etkinleştirir.
- Tür API'si: Zaman Serisi türleri ve ilişkili değişkenleri üzerinde CRUD'i etkinleştirir.
- Hiyerarşiler API'si: Zaman Serisi hiyerarşilerinde CRUD'yi ve bunların ilişkili alan yollarını etkinleştirir.
- Örnekler API'si: Zaman Serisi örnekleri ve ilişkili örnek alanlarında CRUD'ye olanak tanır. Ayrıca, Örnekler API'si aşağıdaki işlemleri destekler:
Zaman Serisi Sorgusu (TSQ) API'leri
Bu API'ler, çok katmanlı depolama çözümümüzdeki her iki mağazada da (Sıcak ve Soğuk) kullanılabilir.
Olay Alma API'si: Kaynak sağlayıcıdan Azure Time Series Insights 2. Nesil'de kaydedilen ham olayların ve ilişkili olay zaman damgalarının sorgulanıp alınmasını sağlar. Bu API, belirli bir Zaman Serisi Kimliği ve arama aralığı için ham olayların alınmasına olanak tanır. Bu API, seçilen girişin tam yanıt veri kümesini almak için sayfalandırmayı destekler.
Önemli
JSON düzleştirme ve kaçış kurallarında yapılacak değişikliklerin bir parçası olarak diziler Dinamik tür olarak depolanır. Bu tür olarak depolanan payload özellikleriNE YALNIZCA Olay Al API'sinde erişilebilir.
Get Series API: Ham olaylara değişkenler tarafından tanımlanan hesaplamaları uygulayarak hesaplanan değerlerin ve ilişkili olay zaman damgalarının sorgu ve alınmasını sağlar. Bu değişkenler Zaman Serisi Modeli'nde tanımlanabilir veya sorguda satır içi olarak sağlanabilir. Bu API, seçilen girişin tam yanıt veri kümesini almak için sayfalandırmayı destekler.
Toplama Serisi API'si: Ham olaylara değişkenler tarafından tanımlanan hesaplamaları uygulayarak toplanan değerlerin ve ilişkili aralık zaman damgalarının sorgulanıp alınmasını sağlar. Bu değişkenler Zaman Serisi Modeli'nde tanımlanabilir veya sorguda satır içi olarak sağlanabilir. Bu API, seçilen girişin tam yanıt veri kümesini almak için sayfalandırmayı destekler.
Belirtilen bir arama aralığı ve aralığı için bu API, bir Zaman Serisi Kimliği için değişken başına aralık başına bir toplu yanıt döndürür. Yanıt veri kümesindeki aralık sayısı, dönem işaretlerini sayarak (Unix dönemi - 1 Ocak 1970'ten bu yana geçen milisaniye sayısı) ve değer çizgilerini sorguda belirtilen aralık aralığı boyutuna bölerek hesaplanır.
Yanıt kümesinde döndürülen zaman damgaları, aralıktaki örneklenen olayların değil, sol aralık sınırlarındandır.
Mağaza Türü Seçme
Yukarıdaki API'ler tek bir çağrıda yalnızca iki depolama türünden birine (Soğuk veya Sıcak) karşı yürütülebilir. Sorgu URL'si parametreleri, sorgunun yürütülmesi gereken depo türünü belirtmek için kullanılır.
Parametre belirtilmezse, sorgu varsayılan olarak Cold Store'da yürütülür. Bir sorgu hem Soğuk hem de Sıcak depolama alanıyla çakışan bir zaman aralığına yayılıyorsa, Sıcak depo yalnızca kısmi veriler içereceğinden en iyi deneyim için sorguyu Soğuk depoya yönlendirmeniz önerilir.
Azure Time Series Insights Gezgini ve Power BI Bağlayıcısı yukarıdaki API'lere çağrı yapar ve uygun olduğunda otomatik olarak doğru storeType parametresini seçer.