Azure Time Series Insights 2. Nesil'deki Verileri Sorgulama

  • Makale
  • Okumak için 3 dakika

Azure Time Series Insights 2. Nesil, genel yüzey API'leri aracılığıyla ortamda depolanan olaylar ve meta veriler üzerinde veri sorgulamayı sağlar. Bu API'ler, TSI Gezgini Azure Time Series Insights tarafından da kullanılır.

  1. Nesil'de üç Azure Time Series Insights kullanılabilir:
  • Ortam API'leri: Bu API'ler 2. Nesil Azure Time Series Insights 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 Modelinde depolanan meta verilerde oluşturma, okuma, güncelleştirme ve silme (CRUD) işlemlerini sağlar. Bunlar örneklere, türlere ve hiyerarşilere erişmek ve bunları düzenlemek için kullanılabilir.
  • Zaman Serisi Sorgusu (TSQ) API'leri: Kaynak sağlayıcıdan kaydedilen telemetri veya olay verilerini alınmasını sağlar ve gelişmiş skaler ve toplama işlevlerini kullanarak veriler üzerinde yüksek performansa sahip hesaplamalar ve toplamalar sağlar.

Azure Time Series Insights 2. Nesil, Zaman Serisi Değişkenleri içinde hesaplamaları ifade etmek için Zengin dize tabanlı ifade dili olan Time Series Expression (TSX) kullanır.

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

Aşağıdaki temel API'ler de desteklene.

Time Series Query'ye genel bakış

Ortam API'leri

  • Ortamlar API'siniAl: Çağıranın erişim yetkisine sahip olduğu ortamların listesini döndürür.
  • Ortam Kullanılabilirlik API'siniAl: Olay sayısı dağıtımını olay zaman damgası üzerinden $ts döndürür. Bu API, varsa zaman aralıklarına göre olay sayısını döndürerek ortamda herhangi bir olay olup olmadığını belirlemeye yardımcı olur.
  • Olay Şeması API'siniAl: 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ür ve ortamın model adı üzerinde GET ve PATCH'i sağlar.
  • TürlerAPI'si: Zaman Serisi türlerinde ve ilişkili değişkenlerinde CRUD'yi sağlar.
  • Hiyerarşiler API'si:Zaman Serisi hiyerarşilerinde ve ilişkili alan yollarında CRUD'yi sağlar.
  • Örnekler API'si:Time Series örneklerinde ve ilişkili örnek alanlarında CRUD'yi sağlar. Ayrıca, Örnekler API'si aşağıdaki işlemleri destekler:
    • Arama:Örnek özniteliklerine göre zaman serisi örnekleri için aramada isabetlerin kısmi listesini alın.
    • Öneri:Örnek özniteliklerine göre zaman serisi örnekleri için aramada isabetlerin kısmi bir listesini arar ve önerir.

Zaman Serisi Sorgusu (TSQ) API'leri

Bu API'ler çok katmanlı depolama çözümde her iki depoda da (Sıcak ve Soğuk) kullanılabilir.

  • Olayları Alma API'si:Ham olayların ve ilişkili olay zaman damgasının kaynak sağlayıcıdan 2. Nesil'e kaydedildiklerinden sorgu ve Azure Time Series Insights 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 sağlar. Bu API, seçilen giriş için tam yanıt veri kümesi almak üzere sayfalamayı destekler.

    Önemli

    JSON düzlük ve kaçış kurallarındayapılacak değişikliklerin bir parçası olarak diziler Dinamik tür olarak depolanır. Bu tür olarak depolanan yük özelliklerine YALNıZLIK OLARAK Olayları Al API'si aracılığıyla erişilebilir.

  • Seri Api'siniAlma: Ham olaylara değişkenler tarafından tanımlanan hesaplamaları uygulayarak hesaplanan değerlerin ve ilişkili olay zaman damgasının sorgulanmasına ve alınmasına olanak sağlar. Bu değişkenler Zaman Serisi Modeli'ne göre tanımlanabilir veya sorguda satır içi olarak sağlanmıştır. Bu API, seçilen giriş için tam yanıt veri kümesi almak üzere sayfalamayı destekler.

  • Toplama Serisi API'si:Ham olaylar üzerinde değişkenler tarafından tanımlanan hesaplamaları uygulayarak toplanan değerlerin ve ilişkili aralık zaman damgasının sorgu ve alınmasını sağlar. Bu değişkenler Zaman Serisi Modeli'ne göre tanımlanabilir veya sorguda satır içi olarak sağlanmıştır. Bu API, seçilen giriş için tam yanıt veri kümesi almak üzere sayfalamayı destekler.

    Belirtilen arama aralığı ve aralığı için bu API, Zaman Serisi Kimliği için değişken başına aralık başına toplu bir yanıt döndürür. Yanıt veri kümesinde 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 değerleri sorguda belirtilen aralık aralığı boyutuna bölünerek hesaplanır.

    Yanıt kümesinde döndürülen zaman damgası, aralıktan alınan örnek olaylardan 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üne (Soğuk veya Sıcak) karşı yürütülür. Sorgu URL'si parametreleri, sorgunun yürütmesi 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 Yarı sıcak depoyu çakışan bir zaman aralığına yayıyorsa, Warm store yalnızca kısmi veriler içerene kadar en iyi deneyim için sorguyu Soğuk depoya yönlendirmenizi öneririz.

Azure Time Series Insights Explorer ve Power BI Bağlayıcısı yukarıdaki API'lere çağrılar ve uygun olduğu yerde otomatik olarak doğru storeType parametresini seçer.

Sonraki adımlar