Mengkueri data dalam set kueri KQL

Dalam artikel ini, Anda mempelajari cara menggunakan set kueri KQL. KQL Queryset adalah item yang digunakan untuk menjalankan kueri, menampilkan, dan mengkustomisasi hasil kueri pada data dari sumber data yang berbeda, seperti Eventhouse, database KQL, dan banyak lagi.

KQL Queryset menggunakan Bahasa Kueri Kusto untuk membuat kueri, dan juga mendukung banyak fungsi SQL. Untuk informasi selengkapnya tentang bahasa kueri, lihat gambaran umum Bahasa Kueri Kusto.

Prasyarat

• Ruang kerja dengan kapasitas yang diaktifkan Microsoft Fabric
• Database KQL dengan izin pengeditan dan data, atau kluster dan database Azure Data Explorer dengan izin AllDatabaseAdmin.

Pilih sumber data

Kueri dijalankan dalam konteks sumber data. Anda dapat mengubah sumber data terkait kapan saja, dan mempertahankan kueri yang disimpan di editor kueri. Anda dapat mengaitkan set kueri KQL Anda dengan beberapa sumber data dari berbagai jenis, termasuk database KQL atau sumber data dari kluster Azure Data Explorer.

Pilih tab yang sesuai dengan jenis sumber data yang Anda inginkan.

Daftar tabel yang terkait dengan sumber data ini muncul di bawah nama sumber data.

Menulis kueri

Setelah tersambung ke sumber data, Anda dapat menjalankan kueri pada data ini. KQL Queryset menggunakan Kusto Query Language (KQL) untuk mengkueri data dari salah satu sumber data yang dapat Anda akses. Untuk mempelajari selengkapnya tentang KQL, lihat ringkasan Bahasa Kueri Kusto.

Contoh berikut menggunakan data yang tersedia untuk umum di https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

1. Tulis atau salin kueri di panel atas Set Kueri KQL.

2. Pilih tombol Jalankan , atau tekan Shift+Enter untuk menjalankan kueri.

   Output kueri yang dihasilkan ditampilkan dalam kisi hasil, yang muncul di bawah panel kueri. Perhatikan pemeriksaan hijau yang menunjukkan bahwa kueri berhasil diselesaikan, dan waktu yang digunakan untuk menghitung hasil kueri.

   

Berinteraksi dengan sumber data

Penjelajah sumber data memungkinkan Anda berpindah antar sumber data yang tersambung ke tab kueri tempat Anda berada.

Di bagian atas panel penjelajah sumber data, di Explorer Anda bisa menggunakan bilah pencarian untuk mencari sumber data tertentu. Anda juga dapat menggunakan pengalih database di bawah bilah pencarian untuk memperluas menu koneksi sumber data. Pilih sumber data yang ingin Anda gunakan. Jika nama tab belum diedit sebelumnya, nama tab secara otomatis dinamai sesuai sumber data.

Panel penjelajah sumber data memiliki dua bagian. Bagian atas mencantumkan semua item di sumber data, dan bagian bawah memperlihatkan semua sumber data yang tersedia dalam set kueri.

Item-item di sumber data

Bagian atas penjelajah sumber data memperlihatkan semua item yang disertakan dalam sumber data yang Anda gunakan.

• Tabel
• Tampilan Materialisasi
• Jalan Pintas
• Fungsi

Pilih panah > di sebelah kiri item yang ingin Anda perluas. Anda dapat melihat lebih detail dengan meng-klik panah > di sebelah kiri item pada tingkat daftar selanjutnya. Misalnya, di bawah tabel , pilih panah > di sebelah kiri tabel untuk memperlihatkan daftar kolom dalam tabel tersebut.

Untuk membuka menu tindakan, arahkan mouse ke atas item di daftar yang diperluas dan pilih menu Tindakan lainnya [...]. Menu memperlihatkan opsi berikut:

• Refresh database
• Menampilkan profil data
• Sisipkan: untuk membuat dan menyalin skrip
• Mendapatkan data: untuk menambahkan sumber data baru
• Buat dasbor
• Hapus tabel

Tindakan yang berbeda tersedia untuk berbagai jenis item.

Sumber data yang tersedia

Bagian bawah penjelajah sumber data memperlihatkan semua sumber data yang tersedia yang telah ditambahkan ke set kueri.

Untuk membuka menu tindakan, arahkan mouse ke atas nama sumber data dan pilih menu tindakan Lainnya [...]. Menu memperlihatkan opsi berikut:

• Refresh database
• Gunakan database ini: beralih untuk menggunakan sumber data ini di tab saat ini
• Kueri di tab baru: buka sumber data ini di tab baru di set kueri
• Menghapus sumber: menghapus semua database di sumber data tersebut
• Menghapus database: menghapus database yang dipilih saja

Salin kueri

Anda mungkin ingin menyalin dan berbagi kueri yang Anda buat.

1. Di bagian atas jendela kueri, pilih tab Beranda .

2. Di panel kueri, pilih Salin kueri.

   

   Tabel berikut menguraikan banyak opsi cara menyalin kueri.

   Tindakan	Deskripsi
   Salin kueri	Salin teks kueri.
   Tautkan ke clipboard	Salin tautan dalam yang dapat digunakan untuk menjalankan kueri.
   Menautkan dan mengkueri ke clipboard	Salin tautan yang dapat digunakan untuk menjalankan kueri dan teks kueri.
   Tautan, kueri, dan hasil ke clipboard	Salin tautan yang dapat digunakan untuk menjalankan kueri, teks kueri, dan hasil kueri.
   Salin hasil	Salin hasil kueri.

3. Pilih tindakan yang diinginkan dari daftar.

4. Tempelkan informasi ini untuk mengedit atau membagikannya, misalnya di Microsoft Word, Microsoft Teams, atau Outlook.

   Penting

   Pengguna yang menerima tautan kueri harus memiliki izin menampilkan data yang mendasar untuk menjalankan kueri dan menampilkan hasil.

Mengelola tab set kueri

Dalam set kueri KQL, Anda bisa membuat beberapa tab. Setiap tab dapat dikaitkan dengan database KQL yang berbeda, dan memungkinkan Anda menyimpan kueri untuk digunakan atau dibagikan nanti dengan orang lain untuk berkolaborasi dalam eksplorasi data. Anda juga bisa mengubah database KQL yang terkait dengan tab apa pun, memungkinkan Anda menjalankan kueri yang sama pada data dalam database yang berbeda.

Anda dapat mengelola tab dengan cara berikut:

• Ubah koneksi sumber data yang ada: Di Explorer dan bilah pencarian, gunakan pengalih database untuk memperluas menu koneksi sumber data.
• Ganti Nama tab: Di samping nama tab, pilih ikon pensil .
• Tambahkan tab baru: Di sebelah kanan tab yang ada di bilah perintah, pilih plus +. Tab yang berbeda dapat disambungkan ke sumber data yang berbeda.
• Tindakan lainnya: Di sisi kanan bilah perintah, ada menu tab dengan lebih banyak tindakan untuk mengelola beberapa tab di set kueri Anda.
• Mengubah posisi tab: Gunakan gerakan seret dan lepas.

Mengekspor data kueri sebagai CSV

Alih-alih hanya menyalin-menempelkan output kueri, Anda juga dapat mengekspor hasil kueri.

Ini adalah metode satu kali untuk mengekspor file CSV yang berisi hasil kueri.

1. Di bagian atas jendela kueri, pilih tab Beranda .

   

2. Di panel kueri, pilih Ekspor ke CSV.

3. Simpan file CSV secara lokal.

Menghapus set kueri KQL

Untuk menghapus set kueri KQL Anda:

1. Pilih ruang kerja tempat set kueri KQL Anda berada.

2. Arahkan mouse ke atas set kueri KQL yang ingin Anda hapus. Pilih Lainnya [...], lalu pilih Hapus.

   

Langkah selanjutnya