Azure Time Series Insights 2. Nesil'deki Verileri Sorgulama

  • Makale

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.

Azure Time Series Insights 2. Nesil, genel surface 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ının kendisinde sorguları etkinleştirir. Bunlar, çağıranın erişimi olan ortamların listesini ve ortam meta verilerini toplamak için kullanılabilir.
  • Zaman Serisi 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şkenlerinde hesaplamaları ifade etmek için zengin dize tabanlı ifade dili olan Time SeriesExpression (TSX) kullanır.

Azure Time Series Insights 2. Nesil API'lerine genel bakış

Aşağıdaki temel API'ler desteklenir.

Time Series Query'ye genel bakış

Ortam API'leri

  • Ortamları Alma API'sini alma: Çağıranın erişim yetkisine sahip olduğu ortamların listesini döndürür.
  • Get Environments Availability API: Olay sayısının olay zaman damgası $tsüzerinden 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-Query (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ürler API'si: Zaman Serisi türleri ve bunların ilişkili değişkenleri üzerinde CRUD'ye olanak tanır.
  • Hiyerarşiler API'si: Zaman Serisi hiyerarşilerinde CRUD'yi ve ilişkili alan yollarını etkinleştirir.
  • Örnekler API'si: Zaman Serisi örneklerinde ve bunların ilişkili örnek alanlarında CRUD'ye olanak tanır. Ayrıca, Örnekler API'si aşağıdaki işlemleri destekler:
    • Arama: Örnek özniteliklerine göre zaman serisi örneklerini ararken isabetlerin kısmi bir listesini alır.
    • Öneri: Örnek özniteliklerine göre zaman serisi örneklerini ararken isabetlerin kısmi bir listesini arar ve önerir.

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'sini alma: Kaynak sağlayıcıdan Azure Time Series Insights 2. Nesil'e 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 yanıt veri kümesinin tamamını 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 yük özellikleriNE YALNIZCA Olay Al API'sini aracılığıyla 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 sorgulanıp alınmasını sağlar. Bu değişkenler Zaman Serisi Modeli'nde tanımlanabilir veya sorguda satır içinde sağlanabilir. Bu API, seçilen girişin yanıt veri kümesinin tamamını 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çinde sağlanabilir. Bu API, seçilen girişin yanıt veri kümesinin tamamını 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 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ünü Seçme

Yukarıdaki API'ler tek bir çağrıda yalnızca iki depolama türünden birinde (Soğuk veya Sıcak) 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, Warm deposu yalnızca kısmi veriler içereceğinden, en iyi deneyim için sorgunun Soğuk depoya yönlendirilmiş olması ö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.

Sonraki adımlar