Partager via

Écrire des requêtes Kusto Query Language dans l’interface utilisateur web d’Azure Data Explorer

  • Article

L’éditeur de requête d’interface utilisateur web Azure Data Explorer propose différentes fonctionnalités pour vous aider à écrire des requêtes Langage de requête Kusto (KQL). Certaines de ces fonctionnalités incluent KQL IntelliSense intégré et la saisie semi-automatique, la documentation inline et les fenêtres contextuelles de correctif rapide. Dans cet article, nous allons mettre en évidence ce que vous devez savoir lors de l’écriture de requêtes KQL dans l’interface utilisateur web.

KQL IntelliSense et saisie semi-automatique

L’éditeur de requête intègre KQL IntelliSense qui propose des suggestions contextuelles pour les fonctions et les opérateurs, ainsi que la saisie semi-automatique qui termine vos requêtes pour vous faire gagner du temps et des efforts.

Pour utiliser KQL IntelliSense et la saisie semi-automatique :

  1. Commencez à taper une requête dans l’éditeur de requête.

  2. KQL IntelliSense active, présentant des options de liste déroulante pour les entités, les opérateurs, les fonctions, etc. Passez entre ces options à l’aide des touches de direction de votre clavier, puis sélectionnez-en une en appuyant sur Entrée ou en sélectionnant l’option avec votre souris.

  3. Si vous remarquez des mots clés soulignés, pointez dessus pour révéler des erreurs ou des suggestions qui ont déclenché la mise en surbrillance.

Capture d’écran de déplacement montrant comment intellisense et la saisie semi-automatique fonctionnent.

Afficher la documentation inline

L’éditeur de requête fournit un accès inline à la documentation pour les opérateurs, fonctions et commandes de gestion KQL.

Pour afficher la documentation inline :

  1. Pointez sur l’opérateur, la fonction ou la commande dans IntelliSense.

  2. Sélectionnez l’icône de flèche droite pour ouvrir un aperçu inline de la documentation.

    Capture d’écran de la documentation de l’opérateur KQL inline.

    Remarque

    La préversion reste active jusqu’à ce que vous le fermiez ou mettez fin à votre session, même pour d’autres opérateurs et fonctions.

  3. Si vous souhaitez ouvrir la documentation complète dans votre navigateur, sélectionnez afficher en ligne.

Correctif rapide : suggestion de requête ou avertissement

L’éditeur de requête fournit des suggestions et des avertissements lorsque vous écrivez vos requêtes. La fonctionnalité de correctif rapide peut être utilisée pour ajuster la requête en fonction de ces suggestions et avertissements.

Pour corriger une requête en fonction d’une suggestion ou d’un avertissement :

  1. Pointez sur le terme pour afficher la suggestion ou l’avertissement.

  2. Sélectionnez Correctif rapide pour afficher les options de correctif rapide disponibles.

  3. Sélectionnez l’option de correction rapide souhaitée.

Capture d’écran du correctif rapide basé sur la suggestion de performances.

Conseil

Pour personnaliser les suggestions et les avertissements que vous recevez, consultez Personnaliser les paramètres dans l’interface utilisateur web d’Azure Data Explorer.

Correctif rapide : Extraire la valeur dans une variable

La fonctionnalité de correction rapide peut également être utilisée pour extraire une valeur dans une variable :

  1. Sélectionnez la valeur à extraire.

  2. Sélectionnez l’icône d’ampoule ou appuyez sur Ctrl +. pour ouvrir les options de correctif rapide.

  3. Sélectionnez Extraire la valeur.

Capture d’écran du correctif rapide pour extraire la valeur dans la variable.

Correctif rapide : Définir des fonctions inline

La fonctionnalité de correctif rapide peut également être utilisée pour définir une fonction existante inline avant son utilisation. L’ajout d’une définition de fonction inline peut être utile pour améliorer la lisibilité et la maintenance de vos requêtes.

Pour afficher une définition de fonction :

  1. Écrivez et sélectionnez le nom de la fonction.

  2. Sélectionnez l’icône d’ampoule ou appuyez sur Ctrl +. pour ouvrir les options de correctif rapide.

  3. Pour définir la fonction inline, sélectionnez Inline (fonction inline) ou Récursive inline (fonction inline).

Capture d’écran de déplacement de la fonctionnalité définir la fonctionnalité de correctif rapide de fonction.

Utiliser les outils KQL

Les outils KQL de la barre d’outils vous aident à dupliquer rapidement une requête, à ouvrir la palette de commandes ou à accéder à la documentation.

Pour utiliser les outils KQL :

  1. Dans la barre d’outils, sélectionnez outils KQL.

  2. Choisissez parmi les options telles que la requête en double, la palette de commandes Ouvrir ou pointez sur Ressources pour accéder aux liens de documentation. Cette liste inclut des ressources telles que la aide-mémoire KQL to SQL, les raccourcis clavier et la documentation de référence rapide KQL.

Capture d’écran de l’option outils KQL dans la barre d’outils de l’interface utilisateur web.

Contenu connexe