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 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 beberapa sumber data dari berbagai jenis, termasuk 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 panel koneksi di sisi kiri halaman kueri, di bawah Penjelajah, pilih V untuk memperluas menu koneksi database.

   

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

4. Di jendela hub data OneLake yang muncul, pilih database KQL untuk menyambungkan ke set kueri KQL Anda, lalu pilih Sambungkan. Atau, tutupjendela hub data OneLake dan gunakan menu +Tambahkan sumber data untuk menyambungkan ke sumber data yang berbeda.

Kluster Azure Data Explorer

1. Buka set kueri KQL Anda.

2. Di panel koneksi di sisi kiri halaman kueri, di bawah Penjelajah, pilih V untuk memperluas menu koneksi database.

   

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

4. Di bawah URI Koneksi, 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.

   

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 muncul di bawah nama database di panel koneksi.

Berinteraksi dengan database menggunakan panel koneksi

Panel koneksi memungkinkan Anda menelusuri dan beralih di antara database yang tersambung ke set kueri. Di panel koneksi, di bawah Database, pilih V untuk memperluas menu koneksi database. Pilih database yang ingin Anda jelajahi. Panel koneksi memperlihatkan perincian item berikut yang disertakan dalam database yang dipilih:

• Tabel
• Tampilan Materialisasi
• Cara pintas
• Fungsi

Di panel koneksi, Anda bisa menjelajahi item apa yang disertakan di setiap bagian. Untuk membuka menu tindakan, arahkan mouse ke atas item dan pilih menu Lainnya [...]. Menu memberikan opsi untuk:

• Merefresh data
• Menampilkan profil data
• Sisipkan untuk membuat skrip dan menempelkannya ke editor kueri
• Hapus

Tindakan yang berbeda tersedia untuk berbagai jenis item.

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

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

Di sisi kanan bilah perintah, ada menu dengan tindakan tambahan untuk mengelola beberapa tab di set kueri Anda.

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

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.

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

Mengkustomisasi hasil dalam kisi hasil KQL Queryset