Mengapa kueri KQL saya menampilkan nilai kosong alih-alih error?

Nama properti dalam KQL peka huruf besar-kecil (case-sensitive). Jika huruf kapital pada nama properti salah, Azure Resource Graph tidak akan menampilkan error sintaks; sebaliknya, sistem diam-diam mengembalikan nilai kosong, sehingga proses debugging menjadi lebih sulit.

Apa itu batas 1.000 record di Azure Resource Graph?

Secara default, kueri resource graph mengembalikan maksimal 1.000 record untuk melindungi pengguna dari pengambilan dataset berukuran besar secara tidak sengaja. Anda dapat melewati atau menelusuri batas ini menggunakan continuation token jika lingkungan Anda berisi ribuan resource.

Kusto Query Language untuk Azure Resource Graph: Panduan untuk Pemula

Q: Apa itu KQL dan mengapa digunakan di Azure Resource Graph?

KQL merupakan singkatan dari Kusto Query Language. Ini adalah bahasa kueri yang ringan dan intuitif, digunakan untuk mengajukan pertanyaan tentang lingkungan Azure Anda di Resource Graph. Dengan sintaks berbasis pipa (|) yang mudah dibaca, Anda dapat memfilter, mengurutkan, dan mengelompokkan ribuan resource cloud secara instan.

Q: Bagaimana cara memfilter resource berdasarkan jenis menggunakan KQL?

Anda dapat memfilter resource dengan menambahkan klausa "where" setelah deklarasi tabel awal. Misalnya, menulis 'resources | where type =~ "microsoft.keyvault/vaults"' hanya akan menampilkan Azure Key Vault Anda.

By Mirko Peters · 2026-10-21

Kuasai Kusto Query Language (KQL) untuk Azure Resource Graph. Pelajari sintaks sederhana, filter pipeline, pipa, dan kueri untuk mengelola lingkungan cloud Anda.

Automatically translated with AI from the original post. Read the English original

Cover: Azure Resource Graph - Simply Explained

Menguasai Kusto Query Language (KQL) untuk Azure Resource Graph memungkinkan administrator cloud menulis kueri yang rapi dan sangat cepat, yang dengan mudah menampilkan inventaris cloud, risiko keamanan, dan kepatuhan tata kelola di berbagai langganan tanpa bergantung pada klik manual di portal.

Poin Penting

Kueri KQL dibaca seperti resep, menggunakan karakter pipa (|) untuk merangkai langkah-langkah pemrosesan data secara berurutan.
Tabel default 'resources' berisi sebagian besar yang Anda butuhkan untuk melakukan kueri di beberapa langganan Azure sekaligus.
Operator project dan extend membantu Anda membersihkan output yang berantakan dan mengekstrak nilai properti bertingkat tanpa kode yang berlebihan.
Resource graph membatasi hasil menjadi 1.000 record secara default sebagai pengaman, sehingga lingkungan besar memerlukan paging token.
Keterampilan KQL yang dipelajari di Azure Resource Graph dapat langsung diterapkan di Log Analytics dan Azure Data Explorer.

Memahami KQL di Azure Resource Graph

Saat pertama kali bertemu Kusto Query Language (KQL), akronimnya mungkin terdengar menakutkan. Namun, setelah istilah teknisnya disingkirkan, terlihat sintaks yang sangat mudah dipahami dan mirip bahasa Inggris, dirancang agar kueri infrastruktur cloud terasa intuitif. Berbeda dengan menulis aplikasi kompleks atau skrip yang rumit, KQL berfokus semata-mata pada pengajuan pertanyaan dan pengambilan data terstruktur.

Setiap pertanyaan yang Anda ajukan di Azure Resource Graph dibangun di atas KQL. Jika Anda pernah menggunakan Azure Data Explorer atau Log Analytics, sintaks ini akan terasa sangat familiar. Namun, meskipun Anda baru memulai dari nol, kurva pembelajarannya ternyata cukup landai. Anda dapat mempelajari inti KQL yang dibutuhkan untuk pengelolaan cloud sehari-hari dalam satu sesi saja.

Anatomi Kueri KQL

Kueri KQL dibaca seperti resep langkah demi langkah. Rahasia keterbacaannya terletak pada karakter pipa (|), yang memisahkan setiap instruksi. Anda memulai dengan tabel data dasar, lalu mengalirkannya ke perintah berikutnya yang mempersempit, memfilter, atau membentuk ulang output.

Baca kueri KQL dari atas ke bawah, dan kueri itu terdengar hampir seperti bahasa Inggris biasa. Misalnya, perhatikan kueri paling sederhana yang berguna untuk Anda tulis:

resources | summarize count

Jika diucapkan, perintah ini berarti: ambil semua data dalam tabel default resources, lalu hitung jumlahnya. Sistem akan merespons dengan satu angka yang sangat berharga, yang mewakili total skala infrastruktur cloud Anda.

Operator Esensial untuk Administrator Cloud

Setelah Anda menguasai cara menghitung aset, Anda akan ingin memfilter dan memformat data. Beberapa operator dasar melakukan pekerjaan berat di hampir setiap kueri administratif:

where: Memfilter dataset berdasarkan kondisi tertentu. Misalnya, dengan mengubah kueri menjadi resources | where type == "Microsoft.Compute/virtualMachines", hitungan Anda hanya akan dibatasi pada mesin virtual.
project: Memilih kolom mana yang muncul di output akhir, sehingga Anda hanya menampilkan nama resource, lokasi, dan ID langganan, alih-alih tumpukan data JSON mentah yang besar.
order by: Mengurutkan hasil secara alfabetis atau numerik, mengubah tumpukan data acak menjadi tabel yang rapi dan mudah dipindai.
extend: Membuat kolom kustom sementara sehingga Anda dapat mengekstrak nilai konfigurasi yang bersarang dalam dan memberinya label singkat yang dapat digunakan kembali.

Menghindari Jebakan Umum KQL

Meskipun KQL cukup fleksibel dalam beberapa hal, KQL memiliki aturan ketat terkait kapitalisasi huruf. Operator pencocokan tidak peka huruf besar-kecil (ditulis sebagai tanda sama dengan dengan tilde, seperti =~) akan mengabaikan perbedaan huruf saat Anda mencari nilai string seperti jenis resource. Namun, nama properti sangat berbeda. Jika Anda salah eja atau salah kapitalisasi nama properti, KQL tidak akan menampilkan kesalahan sintaks yang jelas; sebaliknya, KQL akan diam-diam mengembalikan nilai kosong, sehingga Anda terpaksa mencari bug yang sebenarnya tidak ada dalam logika Anda.

Memanfaatkan Tabel Lebih dari Sekadar Dasar

Meskipun tabel resources menangani sebagian besar pemeriksaan administratif harian, tersedia tabel khusus untuk pekerjaan tata kelola yang lebih mendalam. Ketika Anda perlu mengaudit postur keamanan, meninjau penugasan kebijakan, atau memeriksa wadah organisasi Anda—seperti grup manajemen, langganan, dan grup resource—Anda dapat mengarahkan kueri KQL langsung ke tabel-tabel khusus tersebut.

Karena KQL adalah standar lintas layanan dalam ekosistem Microsoft, menguasai pola-pola ini memberikan efek pengganda karier yang langsung terasa. Kueri yang Anda tulis hari ini untuk membersihkan network security group yatim piatu atau mengidentifikasi virtual machine yang belum diberi tag akan sama bermanfaatnya saat Anda menulis peringatan keamanan di Microsoft Defender atau membangun dasbor operasional di Log Analytics.

Kesimpulan dan Langkah Selanjutnya

Mempelajari Kusto Query Language mengubah Azure Resource Graph dari mesin backend yang misterius menjadi alat manajemen cloud harian favorit Anda. Dengan menggantikan klik portal yang membosankan dan skrip yang rapuh dengan kueri yang ringkas dan mudah dibaca, Anda mendapatkan visibilitas penuh atas lingkungan multi-langganan Anda.

Untuk mendalami cara menyederhanakan alur kerja administrasi cloud Anda, Dengarkan episode lengkapnya untuk mendapatkan wawasan dari para ahli, contoh praktis, dan panduan langsung tentang cara membuat Azure Resource Graph bekerja untuk organisasi Anda.

Pertanyaan Umum

Apa itu KQL dan mengapa digunakan di Azure Resource Graph?

KQL adalah singkatan dari Kusto Query Language. Ini adalah bahasa kueri yang ringan dan intuitif, digunakan untuk mengajukan pertanyaan tentang lingkungan Azure Anda di Resource Graph. KQL memungkinkan Anda memfilter, mengurutkan, dan mengelompokkan ribuan resource cloud secara instan menggunakan sintaks berbasis pipa (pipe) yang mudah dibaca.

Bagaimana cara memfilter resource berdasarkan jenis menggunakan KQL?

Anda dapat memfilter resource dengan menambahkan klausa 'where' setelah deklarasi tabel awal Anda. Misalnya, menulis 'resources | where type =~ "microsoft.keyvault/vaults"' hanya akan mengembalikan Azure Key Vault Anda.

Mengapa kueri KQL saya mengembalikan nilai kosong alih-alih kesalahan?

Nama properti di KQL bersifat peka huruf besar-kecil (case-sensitive). Jika Anda salah kapitalisasi nama properti, Azure Resource Graph tidak akan menampilkan kesalahan sintaks; sebaliknya, ia akan diam-diam mengembalikan nilai kosong, sehingga proses debugging menjadi sulit.

Apa itu batas 1.000 rekaman di Azure Resource Graph?

Secara default, kueri resource graph mengembalikan maksimal 1.000 rekaman untuk melindungi pengguna dari pengambilan kumpulan data besar secara tidak sengaja. Anda dapat melewati atau melakukan paging melalui batas ini menggunakan continuation token jika lingkungan Anda berisi ribuan resource.