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 database KQL.

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 database

Kueri berjalan dalam konteks database. Anda bisa mengubah database terkait kapan saja, dan mempertahankan kueri yang disimpan di editor kueri. Anda dapat mengaitkan set kueri KQL Anda dengan database KQL atau database dari kluster Azure Data Explorer.

Pilih tab yang sesuai dengan jenis database yang Anda inginkan.

KQL Database

1. Buka set kueri KQL Anda.

2. Di bawah Database, pilih V untuk memperluas menu koneksi database.

   

3. Di bawah sumber Koneksi, pilih Hub data OneLake.

4. Di jendela hub data OneLake yang muncul, pilih database KQL, lalu pilih Pilih.

   

Kluster Azure Data Explorer

1. Buka set kueri KQL Anda.

2. Di bawah Database, pilih V untuk memperluas menu koneksi database.

   

3. Di bawah sumber Koneksi, pilih Azure Data Explorer.

4. Di bawah URI Koneksi ion, masukkan URI kluster.

   Untuk menemukan URI koneksi, buka sumber daya kluster Anda di portal Azure. URI koneksi adalah URI yang ditemukan di Gambaran Umum. Untuk menambahkan kluster sampel gratis, tentukan "bantuan" sebagai URI Koneksi ion.

   

5. Di bawah Database, pilih menu dropdown untuk memperluas daftar database di kluster Anda, lalu pilih database.

6. Pilih Sambungkan.

Daftar tabel yang terkait dengan database ini akan muncul di bawah nama database.

Menulis kueri

Setelah tersambung ke sumber data, Anda dapat menjalankan kueri pada data ini. Set Kueri KQL menggunakan Bahasa Kueri Kusto (KQL) untuk mengkueri data dari salah satu database 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 telah berhasil diselesaikan, dan waktu yang digunakan untuk menghitung hasil kueri.

   

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 dapat mengubah database KQL yang terkait dengan tab apa pun, memungkinkan Anda menjalankan kueri yang sama pada data di berbagai status.

• Mengganti nama tab: Pilih ikon pensil di samping nama tab.
• Tambahkan tab baru: Pilih plus + di sebelah kanan tab yang sudah ada. Tab yang berbeda dapat disambungkan ke database yang berbeda.
• Ubah koneksi database yang sudah ada: Di bawah Database, pilih koneksi database yang ada untuk membuka hub data.

Salin kueri

Anda mungkin ingin menyalin atau berbagi kueri yang Anda buat.

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

2. Pilih Salin kueri.

   

   Tabel berikut menguraikan banyak opsi cara berbagi kueri.

   Penting

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

   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 berbagi yang diinginkan dari tabel di atas.

4. Tempelkan informasi ini ke editor apa pun, seperti Microsoft Word.

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

   

2. Pilih Ekspor hasil 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 dikaitkan.

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

   

Langkah selanjutnya

Mengkustomisasi hasil dalam kisi hasil KQL Queryset