Bagikan melalui


Menulis kueri Bahasa Kueri Kusto di antarmuka pengguna web Azure Data Explorer

Editor kueri antarmuka pengguna web Azure Data Explorer menawarkan berbagai fitur untuk membantu Anda menulis kueri Bahasa Kueri Kusto (KQL). Beberapa fitur ini termasuk KQL Intellisense bawaan dan lengkapi otomatis, dokumentasi sebaris, dan pop-up perbaikan cepat. Dalam artikel ini, kami akan menyoroti apa yang harus Anda ketahui saat menulis kueri KQL di UI web.

KQL Intellisense dan lengkapi otomatis

Editor kueri memiliki KQL Intellisense bawaan yang menawarkan saran kontekstual untuk fungsi dan operator, dan lengkapi otomatis yang menyelesaikan kueri Anda untuk menghemat waktu dan upaya Anda.

Untuk menggunakan KQL Intellisense dan lengkapi otomatis:

  1. Mulai ketik kueri di editor kueri.

  2. KQL Intellisense mengaktifkan, menyajikan opsi dropdown untuk entitas, operator, fungsi, dan banyak lagi. Berpindah di antara opsi ini menggunakan tombol panah pada keyboard Anda, dan pilih salah satu dengan menekan Enter atau memilih opsi dengan mouse Anda.

  3. Jika Anda melihat kata kunci bergaris bawah, arahkan mouse ke atasnya untuk mengungkapkan kesalahan atau saran yang memicu penyorotan.

Memindahkan cuplikan layar memperlihatkan cara kerja intellisense dan pelengkapan otomatis.

Menampilkan dokumentasi sebaris

Editor kueri menyediakan akses sebaris ke dokumentasi untuk operator, fungsi, dan perintah manajemen KQL.

Untuk melihat dokumentasi sebaris:

  1. Arahkan mouse ke atas operator, fungsi, atau perintah di Intellisense.

  2. Pilih ikon panah kanan untuk membuka pratinjau sebaris dokumentasi.

    Cuplikan layar dokumentasi operator KQL sebaris.

    Catatan

    Pratinjau tetap aktif sampai Anda menutupnya atau mengakhiri sesi Anda, bahkan untuk operator dan fungsi lain.

  3. Jika Anda ingin membuka dokumentasi lengkap di browser Anda, pilih tampilkan secara online.

Perbaikan cepat: Saran atau peringatan kueri

Editor kueri menyediakan saran dan peringatan saat Anda menulis kueri Anda. Fitur perbaikan cepat dapat digunakan untuk menyesuaikan kueri berdasarkan saran dan peringatan ini.

Untuk memperbaiki kueri berdasarkan saran atau peringatan:

  1. Arahkan mouse ke atas istilah untuk melihat saran atau peringatan.

  2. Pilih Perbaikan cepat untuk menampilkan opsi perbaikan cepat yang tersedia.

  3. Pilih opsi perbaikan cepat yang diinginkan.

Cuplikan layar perbaikan cepat berdasarkan saran performa.

Tip

Untuk mengkustomisasi saran dan peringatan yang Anda terima, lihat Menyesuaikan pengaturan di antarmuka pengguna web Azure Data Explorer.

Perbaikan cepat: Mengekstrak nilai ke dalam variabel

Fitur perbaikan cepat juga dapat digunakan untuk mengekstrak nilai ke dalam variabel:

  1. Pilih nilai yang akan diekstrak.

  2. Pilih ikon bola lampu atau tekan Ctrl + . untuk membuka opsi perbaikan cepat.

  3. Pilih Ekstrak nilai.

Cuplikan layar perbaikan cepat untuk mengekstrak nilai ke variabel.

Perbaikan cepat: Menentukan fungsi sebaris

Fitur perbaikan cepat juga dapat digunakan untuk menentukan fungsi yang ada sebaris sebelum digunakan. Menambahkan definisi fungsi sebaris mungkin berguna untuk meningkatkan keterbacaan dan pemeliharaan kueri Anda.

Untuk memperlihatkan definisi fungsi:

  1. Tulis dan pilih nama fungsi.

  2. Pilih ikon bola lampu atau tekan Ctrl + . untuk membuka opsi perbaikan cepat.

  3. Untuk menentukan fungsi sebaris, pilih Sebaris (Fungsi sebaris) atau Rekursif Sebaris (Fungsi sebaris).

Memindahkan cuplikan layar fitur perbaikan cepat fungsi yang ditentukan.

Menggunakan alat KQL

Alat KQL di toolbar membantu Anda menduplikasi kueri dengan cepat, membuka palet perintah, atau mengakses dokumentasi.

Untuk menggunakan alat KQL:

  1. Di toolbar, pilih alat KQL.

  2. Pilih dari opsi seperti Kueri duplikat, Buka palet perintah, atau arahkan mouse ke atas Sumber Daya untuk mengakses tautan dokumentasi. Daftar ini mencakup sumber daya seperti contekan KQL ke SQL, pintasan Keyboard, dan dokumentasi referensi cepat KQL.

Cuplikan layar opsi alat KQL di toolbar UI web.