Mengkueri Data dari Azure Time Series Insights Gen2

  • Artikel

Catatan

Layanan Time Series Insights (TSI) tidak akan lagi didukung setelah Maret 2025. Pertimbangkan untuk memigrasikan lingkungan TSI yang ada ke solusi alternatif sesegera mungkin. Untuk informasi selengkapnya tentang penghentian dan migrasi, kunjungi dokumentasi kami.

Azure Time Series Insights Gen2 memungkinkan kueri data tentang peristiwa dan metadata yang disimpan di lingkungan melalui API permukaan publik. API ini juga digunakan oleh Azure Time Series Insights TSI Explorer.

Tiga kategori API utama tersedia dalam Azure Time Series Insights Gen2:

  • API Lingkungan: API ini mengaktifkan kueri di lingkungan Azure Time Series Insights Gen2 itu sendiri. API ini dapat digunakan untuk mengumpulkan daftar lingkungan yang dapat diakses pemanggil dan metadata lingkungan.
  • Time Series Model-Query (TSM-Q) API: Memungkinkan operasi buat, baca, perbarui, dan hapus (CRUD) pada metadata yang disimpan dalam Model Time Series lingkungan. API ini dapat digunakan untuk mengakses dan mengedit instans, jenis, dan hierarki.
  • Time Series Query (TSQ) API: Memungkinkan pengambilan data telemetri atau peristiwa seperti yang direkam dari penyedia sumber dan memungkinkan komputasi dan agregasi dengan performa baik pada data menggunakan fungsi skalar dan agregat tingkat lanjut.

Azure Time Series Insights Gen2 menggunakan berbagai bahasa ekspresi berbasis string, Time Series Expression (TSX), untuk mengekspresikan perhitungan dalam Time Series Variables.

Ringkasan Azure Time Series Insights Gen2 API

API core berikut didukung.

Ringkasan Kueri Time Series

API Lingkungan

  • Dapatkan API Lingkungan: Mengembalikan daftar lingkungan yang diizinkan diakses oleh pemanggil.
  • Dapatkan API Ketersediaan Lingkungan: Mengembalikan distribusi jumlah peristiwa melalui tanda waktu peristiwa $ts. API ini membantu menentukan apakah ada peristiwa di lingkungan dengan mengembalikan jumlah peristiwa yang dipecah menjadi interval waktu, jika ada.
  • Dapatkan API Skema Peristiwa: Mengembalikan metadata skema peristiwa untuk rentang pencarian tertentu. API ini membantu mengambil semua metadata dan properti yang tersedia dalam skema untuk rentang pencarian yang diberikan.

Time Series Model-Query (TSM-Q) API

Sebagian besar API ini mendukung operasi eksekusi batch untuk memungkinkan operasi CRUD batch pada beberapa entitas Model Time Series:

  • API Pengaturan Model: Memungkinkan GET dan PATCH pada jenis default dan nama model lingkungan.
  • API Jenis: Memungkinkan CRUD pada jenis Time Series dan variabel terkait.
  • API Hierarki: Memungkinkan hierarki CRUD pada Time Series dan jalur bidang terkait.
  • API Instans: Memungkinkan CRUD pada instans Time Series dan bidang instans terkait. Selain itu, API Instans mendukung operasi berikut:
    • Pencarian: Mengambil sebagian daftar hit pada pencarian instans seri waktu berdasarkan atribut instans.
    • Saran: Mencari dan menyarankan daftar parsial hit pada pencarian instans seri waktu berdasarkan atribut instans.

Time Series Query (TSQ) API

API ini tersedia di kedua penyimpanan (Warn dan Cold) dalam solusi penyimpanan multilapisan kami.

  • Get Events API: Memungkinkan kueri dan pengambilan peristiwa mentah dan tanda waktu terkait saat direkam di Azure Time Series Insights Gen2 dari penyedia sumber. API ini memungkinkan pengambilan peristiwa mentah untuk ID Time Series tertentu dan rentang pencarian. API ini mendukung pemberian nomor halaman untuk mengambil himpunan data respons lengkap untuk input yang dipilih.

    Penting

    Sebagai bagian dari perubahan yang akan datang pada aturan pelepasan dan perataan JSON, array akan disimpan sebagai jenis Dinamis. Properti payload yang disimpan sebagai jenis ini HANYA dapat diakses melalui Get Events API.

  • Get Series API: Memungkinkan kueri dan pengambilan nilai komputasi dan tanda waktu peristiwa terkait dengan menerapkan perhitungan yang ditentukan oleh variabel pada peristiwa mentah. Variabel ini dapat didefinisikan baik dalam Model Time Series maupun disediakan sebaris dalam kueri. API ini mendukung pemberian nomor halaman untuk mengambil himpunan data respons lengkap untuk input yang dipilih.

  • Aggregate Series API: Memungkinkan kueri dan pengambilan nilai agregat dan tanda waktu interval terkait dengan menerapkan perhitungan yang ditentukan oleh variabel pada peristiwa mentah. Variabel ini dapat didefinisikan baik dalam Model Time Series maupun disediakan sebaris dalam kueri. API ini mendukung pemberian nomor halaman untuk mengambil himpunan data respons lengkap untuk input yang dipilih.

    Untuk rentang pencarian dan interval tertentu, API ini mengembalikan respons agregat per interval per variabel untuk ID Time Series. Jumlah interval dalam kumpulan data respons dihitung dengan menghitung tanda epoch (jumlah milidetik yang telah berlalu sejak epoch Unix - 1 Januari 1970) dan membagi tanda dengan ukuran rentang interval yang ditentukan dalam kueri.

    Tanda waktu yang dikembalikan dalam kumpulan respons adalah dari batas interval kiri, bukan dari peristiwa sampel dari interval.

Memilih Jenis Penyimpanan

API di atas hanya dapat menjalankan terhadap salah satu dari dua jenis penyimpanan (Cold atau Warm) dalam satu panggilan. Parameter URL kueri digunakan untuk menentukan tipe penyimpanan tempat kueri akan dijalankan.

Jika tidak ada parameter yang ditentukan, kueri akan dijalankan di Penyimpanan Cold, secara default. Jika kueri mencakup rentang waktu yang tumpang tindih dengan penyimpanan Cold dan Warm, sebaiknya rutekan kueri ke penyimpanan Cold untuk pengalaman terbaik karena penyimpanan Warm hanya akan berisi data parsial.

Azure Time Series Insights Explorer dan Power BI Connector melakukan panggilan ke API di atas dan akan secara otomatis memilih parameter storeType yang benar jika relevan.

Langkah berikutnya