Baca dalam bahasa Inggris

Bagikan melalui


Konektor Azure Data Explorer untuk Microsoft Power Automate

Penting

Konektor ini dapat digunakan dalam Real-Time Intelligence di Microsoft Fabric. Gunakan instruksi dalam artikel ini dengan pengecualian berikut:

  • Jika diperlukan, buat database menggunakan instruksi di Membuat database KQL.
  • Jika diperlukan, buat tabel menggunakan instruksi di Membuat tabel kosong.
  • Dapatkan URI kueri atau penyerapan menggunakan instruksi di Salin URI.
  • Jalankan kueri dalam set kueri KQL.

Konektor Azure Data Explorer untuk Power Automate (sebelumnya Microsoft Flow) memungkinkan Anda mengatur dan menjadwalkan alur, mengirim pemberitahuan, dan pemberitahuan, sebagai bagian dari tugas terjadwal atau dipicu.

Anda dapat:

  • Kirim pemberitahuan dan pemberitahuan berdasarkan hasil kueri, seperti saat ambang batas melebihi batas tertentu.
  • Kirim reguler, seperti harian atau mingguan, laporan yang berisi tabel dan bagan.
  • Jadwalkan pekerjaan reguler menggunakan perintah manajemen pada kluster. Misalnya, salin data dari satu tabel ke tabel lainnya menggunakan .set-or-append perintah .
  • Ekspor dan impor data antara Azure Data Explorer dan database lainnya.

Untuk informasi selengkapnya, lihat Contoh penggunaan konektor Azure Data ExplorerPower Automate.

Catatan

Agar Power Automate konektor dapat mengakses kluster yang dilindungi jaringan, Anda harus menambahkan alamat IP keluar yang terkait dengan wilayah konektor Anda ke daftar yang diizinkan firewall. Untuk informasi selengkapnya, lihat Mengelola akses publik ke kluster Azure Data Explorer Anda.

Membuat alur baru menggunakan konektor Azure Data Explorer

Untuk menggunakan konektor, Anda harus terlebih dahulu menambahkan pemicu. Anda dapat menentukan pemicu berdasarkan periode waktu berulang, atau sebagai respons terhadap tindakan alur sebelumnya.

  1. Masuklah ke Power Automate.

  2. Buat alur baru, atau, dari Power Automate halaman beranda, pilih Alur> saya+ Alur baru.

    Power Automate Cuplikan layar halaman beranda, memperlihatkan Alur saya dan Baru disorot.

  3. Pilih Alur cloud terjadwal.

    Cuplikan layar kotak dialog Baru, memperlihatkan Terjadwal dari kosong disorot.

  4. Di Bangun alur cloud terjadwal, masukkan informasi yang diperlukan.

    Cuplikan layar halaman Buat alur terjadwal, memperlihatkan opsi Nama alur disorot.

  5. Pilih Buat>+ Langkah baru.

  6. Dalam kotak pencarian, masukkan Kusto atau Azure Data Explorer, dan pilih Azure Data Explorer.

    Cuplikan layar Pilih jendela operasi, memperlihatkan kotak pencarian dan Azure Data Explorer disorot.

  7. Pilih tindakan dari daftar. Untuk penjelasan tentang setiap tindakan dan cara mengonfigurasinya, lihat Tindakan alur.

    Penting

    Anda harus memiliki koneksi Azure Data Explorer yang valid agar alur Anda berjalan. Untuk informasi tentang membuat koneksi, lihat Membuat koneksi Azure Data Explorer di Power Automate.

    Cuplikan layar daftar Pilih tindakan, memperlihatkan daftar tindakan yang disorot.

Tindakan alur

Saat Anda memilih konektor Azure Data Explorer, Anda dapat memilih salah satu tindakan berikut untuk ditambahkan ke alur Anda:

Bagian ini menjelaskan kemampuan dan parameter untuk setiap tindakan dan memberikan contoh yang menunjukkan cara menambahkan tindakan email ke alur apa pun.

Menjalankan kueri KQL

Catatan

Jika kueri Anda dimulai dengan titik, itu adalah perintah manajemen. Gunakan perintah Jalankan manajemen asinkron.

Gunakan tindakan ini untuk mengkueri kluster yang ditentukan. Tindakan yang ditambahkan setelahnya berulang di setiap baris hasil kueri.

Jika kueri membutuhkan waktu lebih dari 8 menit untuk dijalankan, kueri akan gagal dengan pengecualian "RequestTimeout". Untuk mencegah masalah ini, optimalkan kueri Anda atau bagi menjadi bagian yang lebih kecil. Untuk informasi selengkapnya, lihat Praktik terbaik kueri.

Contoh

Alur berikut memicu kueri setiap menit. Kueri memeriksa jumlah rekaman dalam tabel, lalu mengirim email hanya jika jumlah rekaman lebih besar dari 0.

Cuplikan layar konektor Azure Data Explorer, memperlihatkan tindakan Jalankan kueri KQL.

Menjalankan kueri KQL dan merender bagan

Catatan

Jika kueri Anda dimulai dengan titik, itu adalah perintah manajemen. Gunakan perintah Jalankan manajemen dan render bagan.

Gunakan tindakan ini untuk memvisualisasikan hasil kueri KQL sebagai tabel atau bagan. Misalnya, gunakan alur ini untuk menerima laporan harian melalui email.

Jika kueri membutuhkan waktu lebih dari 8 menit untuk dijalankan, kueri akan gagal dengan pengecualian "RequestTimeout". Untuk mencegah masalah ini, optimalkan kueri Anda atau bagi menjadi bagian yang lebih kecil. Untuk informasi selengkapnya, lihat Praktik terbaik kueri.

Contoh

Alur berikut akan menyajikan hasil kueri sebagai bagan waktu.

Cuplikan layar konektor Azure Data Explorer, memperlihatkan tindakan Jalankan kueri KQL dan render bagan.

Jalankan perintah manajemen asinkron

Gunakan tindakan ini untuk menjalankan perintah manajemen secara asinkron, yang berarti akan terus berjalan di latar belakang. Tindakan mengembalikan ID, status, dan status. Untuk memeriksa status dan detail perintah asinkron, gunakan perintah operasi .show dengan ID yang dikembalikan oleh tindakan ini.

Jika perintah manajemen asinkron membutuhkan waktu lebih dari 60 menit untuk dijalankan, perintah tersebut akan gagal dengan pengecualian "RequestTimeout".

Contoh

Alur berikut memicu perintah asinkron untuk menyalin 10 rekaman dari tabel 'TransformedSysLogs' ke 'TargetTable'. Perhatikan bahwa kata kunci 'asinkron' diperlukan dalam kueri.

Cuplikan layar konektor Azure Data Explorer, memperlihatkan tindakan Jalankan perintah manajemen asinkron.

Menjalankan perintah manajemen dan merender bagan

Gunakan tindakan ini untuk menjalankan perintah manajemen dan menampilkan hasilnya sebagai bagan. Opsi bagan menyertakan tabel HTML, bagan pai, bagan waktu, dan bagan batang.

Jika perintah manajemen membutuhkan waktu lebih dari 8 menit untuk dijalankan, perintah akan gagal dengan pengecualian "RequestTimeout".

Cuplikan layar perintah Jalankan manajemen dan render bagan di panel pengulangan.

Jalankan perintah manajemen peragaan

Tindakan ini menjalankan perintah manajemen acara dan mengembalikan hasil yang dapat digunakan dalam konektor berikut.

Jika perintah manajemen membutuhkan waktu lebih dari 8 menit untuk dijalankan, perintah akan gagal dengan pengecualian "RequestTimeout".

Contoh

Alur berikut menjalankan perintah operasi .show untuk menemukan status perintah asinkron menggunakan ID operasi yang dikembalikan oleh eksekusi perintah asinkron.

Cuplikan layar konektor Azure Data Explorer, memperlihatkan tindakan Jalankan perintah manajemen peragaan.

Hasil kueri Email Kusto

Anda dapat menyertakan langkah dalam alur apa pun untuk mengirim laporan melalui email, ke alamat email apa pun.

  1. Pilih + Langkah Baru untuk menambahkan langkah baru ke alur Anda.
  2. Dalam kotak pencarian, masukkan Office 365 dan pilih Office 365 Outlook.
  3. Pilih Kirim email (V2).
  4. Masukkan alamat email yang ingin Anda kirimi laporan email.
  5. Masukkan subjek email.
  6. Pilih Tampilan kode.
  7. Letakkan kursor Anda di bidang Isi , dan pilih Tambahkan konten dinamis.
  8. Pilih BodyHtml. Cuplikan layar kotak dialog Kirim email, dengan bidang Isi dan BodyHtml disorot.
  9. Pilih Perlihatkan opsi tingkat lanjut.
  10. Di bawah Nama Lampiran -1, pilih Nama Lampiran.
  11. Di bawah Konten Lampiran, pilih Konten Lampiran.
  12. Jika perlu, tambahkan lebih banyak lampiran.
  13. Jika perlu, atur tingkat kepentingan.
  14. Pilih Simpan.

Cuplikan layar kotak dialog Kirim email, dengan Nama Lampiran, Konten Lampiran, dan Simpan disorot.

Membuat koneksi Azure Data Explorer

Untuk menjalankan alur yang berisi konektor Azure Data Explorer, Anda harus menggunakan koneksi Azure Data Explorer yang valid. Anda dapat membuat dan mengautentikasi koneksi baru dari Power Automate panel kiri, pilih Koneksi Data>atau dari dalam alur, dengan memilih menu >Konektor Azure Data Explorer Tambahkan koneksi baru.

Langkah-langkah berikut menunjukkan cara membuat koneksi dari dalam alur.

  1. Di Jalankan kueri KQL, pilih tiga titik di kanan atas konektor power automate.

    Cuplikan layar koneksi Azure Data Explorer, memperlihatkan opsi autentikasi.

  2. Pilih Tambahkan koneksi baru. Saat Anda tersambung untuk pertama kalinya, Anda diminta untuk masuk untuk mengautentikasi koneksi.

    Cuplikan layar koneksi Azure Data Explorer, memperlihatkan opsi masuk.

Autentikasi

Anda dapat mengautentikasi dengan kredensial pengguna atau dengan aplikasi Microsoft Entra. Untuk mengautentikasi dengan kredensial, pilih Masuk, dan masukkan kredensial Anda.

Untuk mengautentikasi dengan Perwakilan Layanan:

  1. Pilih Sambungkan dengan Prinsipal Layanan.

  2. Isi formulir dengan informasi berikut:

    • Nama Koneksi: Nama deskriptif dan bermakna untuk koneksi baru. Dalam contoh ini, kami telah menggunakan "MyApplication".
    • ID Klien: ID aplikasi Anda.
    • Rahasia Klien: Kunci aplikasi Anda.
    • Penyewa: ID direktori Microsoft Entra tempat Anda membuat aplikasi.

    Catatan

    Pastikan aplikasi Anda adalah aplikasi Microsoft Entra dan berwenang untuk menjalankan kueri di kluster Anda.

    Cuplikan layar koneksi Azure Data Explorer, memperlihatkan kotak dialog autentikasi aplikasi.

    Setelah autentikasi selesai, verifikasi bahwa alur Anda menggunakan koneksi baru.

    Cuplikan layar autentikasi aplikasi yang telah selesai.

    Setelah koneksi diatur, alur berjalan menggunakan kredensial aplikasi.

Uji aliran

Untuk memeriksa apakah alur Anda berfungsi, periksa riwayat eksekusi alur:

  1. Power Automate Buka halaman beranda.

  2. Dari menu utama, pilih Alur saya.

    Power Automate Cuplikan layar menu utama, memperlihatkan Alur saya disorot.

  3. Pada baris alur yang ingin Anda selidiki, pilih ikon perintah lainnya, lalu pilih Jalankan riwayat.

    Cuplikan layar tab Alur saya, memperlihatkan Riwayat eksekusi disorot.

    Semua eksekusi alur dicantumkan, dengan informasi tentang waktu mulai, durasi, dan status. Cuplikan layar halaman Jalankan hasil riwayat.

    Untuk detail lengkap tentang alur, pada Alur saya, pilih alur yang ingin Anda selidiki.

    Cuplikan layar halaman Hasil lengkap riwayat eksekusi.

Untuk melihat mengapa eksekusi gagal, pilih waktu mulai eksekusi. Alur muncul, dan langkah alur yang gagal ditunjukkan oleh tanda seru merah. Perluas langkah yang gagal untuk melihat detailnya. Panel Detail di sebelah kanan berisi informasi tentang kegagalan sehingga Anda dapat memecahkan masalahnya.

Cuplikan layar eksekusi alur, memperlihatkan pesan kesalahan.

Batasan

  • Jumlah maksimum rekaman per permintaan adalah 50.000 dan ukuran data maksimum per permintaan adalah 32 MB. Batas ini tidak dapat diubah.
  • Permintaan sinkron memiliki batas waktu 8 menit.
  • Permintaan asinkron memiliki batas waktu 60 menit.
  • Konektor tidak mendukung operator yang tidak didukung oleh getschema operator. Misalnya, operator fork, faset, dan evaluasi tidak didukung.
  • Alur berfungsi paling baik di Microsoft Edge dan Google Chrome.
  • Gunakan Konektor aplikasi Logika Azure Kusto untuk menjalankan kueri dan perintah Kusto sebagai bagian dari tugas terjadwal atau dipicu.