Bagikan melalui

Mengkueri Data dari Azure Time Series Insights Gen2

  • Artikel

Nota

Layanan Time Series Insights akan dihentikan pada 7 Juli 2024. Pertimbangkan untuk memigrasikan lingkungan 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 pada 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 di Azure Time Series Insights Gen2:

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

Azure Time Series Insights Gen2 menggunakan bahasa ekspresi berbasis string yang kaya, Time Series Expression (TSX), untuk mengekspresikan perhitungan dalam Variabel Rangkaian Waktu .

Gambaran umum API Azure Time Series Insights Gen2

API inti berikut didukung.

gambaran umum Kueri Rangkaian Waktu

API Lingkungan

  • Get Environments API: Mengembalikan daftar lingkungan yang diizinkan untuk diakses oleh pemanggil.
  • Get Environments Availability API: Mengembalikan distribusi jumlah peristiwa selama tanda waktu peristiwa $ts. API ini membantu menentukan apakah ada peristiwa di lingkungan dengan mengembalikan jumlah peristiwa yang dipecah menjadi interval waktu, jika ada.
  • Get Event Schema API: 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 mengaktifkan operasi CRUD batch pada beberapa entitas Model Time Series:

  • API Pengaturan Model: Mengaktifkan GET dan PATCH pada tipe bawaan dan nama model dari lingkungan sistem.
  • Jenis API: Mengaktifkan CRUD pada jenis Time Series dan variabel terkaitnya.
  • Hierarki API: Memungkinkan operasi CRUD pada hierarki Deret Waktu dan jalur bidang terkait.
  • Instances API: Mengaktifkan CRUD pada instans Time Series dan bidang instans terkait. Selain itu, Instances API mendukung operasi berikut:
    • Search: Mengambil daftar hit parsial pada pencarian instans rangkaian waktu berdasarkan atribut instans.
    • Sarankan: Mencari dan menyarankan daftar sebagian temuan pada pencarian instans rangkaian waktu berdasarkan atribut instans.

API Kueri Rangkaian Waktu (TSQ)

API ini tersedia di kedua toko (Hangat dan Dingin) dalam solusi penyimpanan multilayer kami.

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

    Penting

    Sebagai bagian dari perubahan yang akan datang pada aturan meratakan dan mengeskapisasi JSON, array akan disimpan sebagai tipe 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 ditentukan dalam Model Time Series atau disediakan sebaris dalam kueri. API ini mendukung paginasi untuk mengambil kumpulan 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 ditentukan dalam Model Time Series atau disediakan sebaris dalam kueri. API ini mendukung paginasi untuk mengambil himpunan data respons lengkap dari input yang dipilih.

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

    Penanda waktu yang dikembalikan dalam set respons adalah batas awal interval, bukan dari peristiwa yang diambil sampelnya dari interval tersebut.

Memilih Jenis Penyimpanan

API di atas hanya dapat dijalankan terhadap salah satu dari dua jenis penyimpanan (Dingin atau Hangat) dalam satu panggilan. Parameter URL kueri digunakan untuk menentukan jenis penyimpanan kueri harus dijalankan.

Jika tidak ada parameter yang ditentukan, kueri akan dijalankan di Cold Store, secara default. Jika kueri mencakup rentang waktu yang tumpang tindih dengan penyimpanan Dingin dan Hangat, disarankan untuk merutekan kueri ke penyimpanan Dingin untuk pengalaman terbaik karena penyimpanan Hangat hanya akan berisi data parsial.

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

Langkah berikutnya