Konektor Azure Data Explorer untuk MicrosoftPower Automate

Penting

Konektor ini dapat digunakan dalam Analitik Real Time 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 izin 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. Masuk ke Power Automate.

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

   

3. Pilih Alur cloud terjadwal.

   

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

   

5. Pilih Buat>+ Langkah baru.

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

   

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.

   

Tindakan alur

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

• Menjalankan kueri KQL
• Menjalankan kueri KQL dan merender bagan
• Jalankan perintah manajemen asinkron
• Menjalankan perintah manajemen dan merender bagan
• Jalankan perintah manajemen peragaan

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 atas 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.

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.

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.

Menjalankan perintah manajemen dan merender bagan

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

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

Jalankan perintah manajemen peragaan

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

Jika perintah manajemen membutuhkan waktu lebih dari 8 menit untuk dijalankan, perintah tersebut 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.

Email hasil kueri 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 Anda inginkan untuk mengirim laporan email.
5. Masukkan subjek email.
6. Pilih Tampilan kode.
7. Tempatkan kursor Anda di bidang Isi , dan pilih Tambahkan konten dinamis.
8. Pilih BodyHtml.
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.

Membuat koneksi Azure Data Explorer

Untuk menjalankan alur yang berisi konektor Azure Data Explorer, Anda harus menggunakan koneksi Azure Data Explorer yang valid. Anda bisa membuat dan mengautentikasi koneksi baru dari Power Automate panel kiri, pilihKoneksiData> 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.

   

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

   

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 pada kluster Anda.

   

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

   

   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.

   

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

   

   Semua eksekusi alur dicantumkan, dengan informasi tentang waktu mulai, durasi, dan status.

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

   

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 bisa memecahkan masalahnya.

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.

Konten terkait

• Gunakan konektor Azure Kusto Logic App untuk menjalankan kueri dan perintah Kusto sebagai bagian dari tugas terjadwal atau dipicu.