Kusto Query Language pour Azure Resource Graph : guide du débutant

By Mirko Peters · 2026-10-21

Maîtrisez le Kusto Query Language (KQL) pour Azure Resource Graph. Découvrez une syntaxe simple, les filtres de pipeline, les barres verticales et les requêtes pour gérer votre environnement cloud.

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

Maîtriser le Kusto Query Language (KQL) pour Azure Resource Graph permet aux administrateurs cloud d'écrire des requêtes claires et très rapides, qui font remonter sans effort l'inventaire cloud, les risques de sécurité et la conformité en matière de gouvernance sur plusieurs abonnements, sans passer par des clics manuels dans le portail.

Points clés

• Les requêtes KQL se lisent comme une recette : la barre verticale (|) enchaîne les étapes successives de traitement des données.
• La table par défaut 'resources' contient la plupart des données dont vous avez besoin pour interroger simultanément plusieurs abonnements Azure.
• Les opérateurs project et extend vous aident à nettoyer des résultats désordonnés et à extraire des valeurs de propriétés imbriquées, sans alourdir le code.
• Par défaut, Resource Graph limite les résultats à 1 000 enregistrements, une protection qui exige l'utilisation de jetons de pagination pour les environnements volumineux.
• Les compétences KQL acquises dans Azure Resource Graph se transposent directement à Log Analytics et Azure Data Explorer.

Démystifier KQL dans Azure Resource Graph

Lorsqu'on découvre pour la première fois le Kusto Query Language (KQL), l'acronyme peut sembler intimidant. Pourtant, une fois le jargon technique mis de côté, on découvre une syntaxe étonnamment accessible, proche de l'anglais, conçue pour interroger l'infrastructure cloud de façon intuitive. Contrairement à la rédaction d'applications complexes ou de scripts lourds, KQL se concentre uniquement sur la formulation de questions et la récupération de données structurées.

Chaque question posée dans Azure Resource Graph repose sur KQL. Si vous avez déjà utilisé Azure Data Explorer ou Log Analytics, cette syntaxe vous paraîtra immédiatement familière. Mais même si vous partez de zéro, la courbe d'apprentissage est étonnamment douce. Vous pouvez acquérir le socle de KQL nécessaire à la gestion quotidienne du cloud en une seule session.

Anatomie d'une requête KQL

Une requête KQL se lit comme une recette, étape par étape. Le secret de cette lisibilité tient à la barre verticale (|), qui sépare les instructions successives. Vous partez d'une table de données de base, puis vous la faites passer par des commandes successives qui restreignent, filtrent ou remodèlent le résultat.

Lue de haut en bas, une requête KQL se rapproche presque d'un langage courant. Prenons par exemple la requête utile la plus simple que vous puissiez écrire :

resources | summarize count

Dit à voix haute, cette commande se traduit ainsi : prenez l'intégralité de la table par défaut resources et donnez-moi un comptage. Le système renvoie un nombre unique et très précieux, qui représente l'envergure totale de votre patrimoine cloud.

Opérateurs essentiels pour les administrateurs cloud

Une fois le comptage de vos actifs maîtrisé, vous voudrez filtrer et mettre en forme les données. Quelques opérateurs fondamentaux font l'essentiel du travail dans presque toutes les requêtes d'administration :

• where : Filtre votre jeu de données selon des conditions précises. Par exemple, en modifiant votre requête pour obtenir resources | where type == "Microsoft.Compute/virtualMachines", vous limitez strictement votre comptage aux machines virtuelles.
• project : Sélectionne les colonnes qui apparaissent dans le résultat final. Vous pouvez ainsi afficher uniquement le nom de la ressource, son emplacement et l'ID de l'abonnement, au lieu d'un mur de données JSON brutes.
• order by : Trie vos résultats par ordre alphabétique ou numérique, et transforme un export de données désordonné en un tableau clair et facile à parcourir.
• extend : Crée une colonne personnalisée temporaire, vous permettant d’extraire des valeurs de configuration profondément imbriquées et de leur attribuer des libellés courts et réutilisables.

Éviter les pièges courants de KQL

Si KQL se montre souple sur certains points, il applique des règles strictes en matière de casse. L’opérateur de correspondance sans distinction de casse (écrit sous la forme d’un signe égal suivi d’un tilde, comme =~) ignore volontiers la casse lorsque vous recherchez des valeurs de type chaîne, comme des types de ressources. En revanche, les noms de propriétés sont tout autres. Si vous commettez une faute de frappe ou une erreur de casse dans un nom de propriété, KQL ne renverra pas d’erreur de syntaxe explicite ; il renverra discrètement des valeurs vides, vous laissant chercher un bogue qui n’existe pas dans votre logique.

Exploiter les tables au-delà des bases

Si la table resources couvre la grande majorité des contrôles administratifs quotidiens, des tables spécialisées existent pour les travaux de gouvernance plus approfondis. Lorsque vous devez auditer des postures de sécurité, examiner des affectations de stratégies ou inspecter vos conteneurs organisationnels — tels que les groupes d’administration, les abonnements et les groupes de ressources —, vous pouvez diriger vos requêtes KQL directement vers ces tables dédiées.

KQL étant un standard transversal dans l’écosystème Microsoft, maîtriser ces schémas constitue un levier de carrière immédiat. Les requêtes que vous écrivez aujourd’hui pour nettoyer des groupes de sécurité réseau orphelins ou repérer des machines virtuelles sans balises vous serviront tout autant lorsque vous rédigerez des alertes de sécurité dans Microsoft Defender ou des tableaux de bord opérationnels dans Log Analytics.

Conclusion et prochaines étapes

Apprendre le langage de requête Kusto transforme Azure Resource Graph, d’un moteur en arrière-plan mystérieux, en votre outil de gestion cloud quotidien préféré. En remplaçant les clics fastidieux dans le portail et les scripts fragiles par des requêtes concises et lisibles, vous obtenez une visibilité totale sur votre environnement multi-abonnements.

Pour approfondir la simplification de vos flux de travail d’administration cloud, écoutez l’épisode complet pour découvrir davantage d’analyses d’experts, d’exemples pratiques et de conseils concrets pour faire fonctionner Azure Resource Graph dans votre organisation.

Questions fréquentes

Qu’est-ce que KQL et pourquoi est-il utilisé dans Azure Resource Graph ?

KQL signifie Kusto Query Language. Il s’agit d’un langage de requête léger et intuitif, utilisé pour interroger votre environnement Azure dans Resource Graph. Il permet de filtrer, trier et regrouper instantanément des milliers de ressources cloud à l’aide d’une syntaxe lisible fondée sur le caractère pipe (|).

Comment filtrer les ressources par type avec KQL ?

Vous pouvez filtrer les ressources en ajoutant une clause 'where' après la déclaration initiale de votre table. Par exemple, l’écriture de 'resources | where type =~ "microsoft.keyvault/vaults"' ne renverra que vos coffres de clés Azure.

Pourquoi ma requête KQL renvoie-t-elle des valeurs vides au lieu d’une erreur ?

Les noms de propriétés dans KQL sont sensibles à la casse. Si vous commettez une erreur de casse dans un nom de propriété, Azure Resource Graph ne renverra pas d’erreur de syntaxe ; il renverra discrètement des valeurs vides, ce qui rend le débogage délicat.

Qu’est-ce que la limite de 1 000 enregistrements dans Azure Resource Graph ?

Par défaut, une requête Resource Graph renvoie un maximum de 1 000 enregistrements afin de protéger les utilisateurs contre l’extraction accidentelle de jeux de données volumineux. Vous pouvez contourner cette limite ou la parcourir par pages à l’aide de jetons de continuation si votre environnement comporte des milliers de ressources.