Schreiben Kusto-Abfragesprache Abfragen auf der Azure Data Explorer-Weboberfläche

  • Artikel

Der Azure Data Explorer Web UI-Abfrage-Editor bietet verschiedene Features, mit denen Sie KQL-Abfragen (Kusto-Abfragesprache) schreiben können. Zu diesen Features gehören integrierte KQL-IntelliSense- und AutoVervollständigen-Funktionen, Inlinedokumentation und Popups für schnelle Korrekturen. In diesem Artikel wird erläutert, was Sie beim Schreiben von KQL-Abfragen in der Web-Benutzeroberfläche wissen sollten.

KQL IntelliSense und AutoVervollständigen

Der Abfrage-Editor verfügt über integriertes KQL-IntelliSense, das kontextbezogene Vorschläge für Funktionen und Operatoren bietet, sowie automatische Vervollständigung, mit der Ihre Abfragen abgeschlossen werden, um Zeit und Aufwand zu sparen.

So verwenden Sie KQL IntelliSense und AutoVervollständigen:

  1. Beginnen Sie mit der Eingabe einer Abfrage im Abfrage-Editor.

  2. KQL IntelliSense wird aktiviert und zeigt Dropdownoptionen für Entitäten, Operatoren, Funktionen und vieles mehr an. Wechseln Sie mit den Pfeiltasten auf der Tastatur zwischen diesen Optionen, und wählen Sie eine aus, indem Sie die EINGABETASTE drücken oder die Option mit der Maus auswählen.

  3. Wenn Sie unterstrichene Schlüsselwörter bemerken, zeigen Sie darauf, um Fehler oder Vorschläge anzuzeigen, die die Hervorhebung ausgelöst haben.

Bewegender Screenshot, der zeigt, wie IntelliSense und AutoVervollständigen funktionieren.

Inlinedokumentation anzeigen

Der Abfrage-Editor bietet Inlinezugriff auf die Dokumentation für KQL-Operatoren, -Funktionen und -Verwaltungsbefehle.

So zeigen Sie die Inlinedokumentation an:

  1. Zeigen Sie auf den Operator, die Funktion oder den Befehl in IntelliSense.

  2. Klicken Sie auf das Pfeilsymbol nach rechts, um eine Inlinevorschau der Dokumentation zu öffnen.

    Screenshot der Dokumentation zum Inline-KQL-Operator.

    Hinweis

    Die Vorschau bleibt aktiv, bis Sie sie schließen oder Ihre Sitzung beenden, auch für andere Operatoren und Funktionen.

  3. Wenn Sie die vollständige Dokumentation in Ihrem Browser öffnen möchten, wählen Sie Online anzeigen aus.

Schnellkorrektur: Abfragevorschlag oder Warnung

Der Abfrage-Editor stellt Vorschläge und Warnungen bereit, während Sie Ihre Abfragen schreiben. Die Schnellkorrekturfunktion kann verwendet werden, um die Abfrage basierend auf diesen Vorschlägen und Warnungen anzupassen.

So korrigieren Sie eine Abfrage basierend auf einem Vorschlag oder einer Warnung:

  1. Zeigen Sie auf den Begriff, um den Vorschlag oder die Warnung anzuzeigen.

  2. Wählen Sie Schnellkorrektur aus , um die verfügbaren Optionen für schnelle Korrekturen anzuzeigen.

  3. Wählen Sie die gewünschte Schnellkorrekturoption aus.

Screenshot der schnellen Korrektur basierend auf dem Leistungsvorschlag.

Tipp

Informationen zum Anpassen der erhaltenen Vorschläge und Warnungen finden Sie unter Anpassen von Einstellungen in der Azure Data Explorer Web-Benutzeroberfläche.

Schnellkorrektur: Extrahieren des Werts in eine Variable

Die Schnellkorrekturfunktion kann auch verwendet werden, um einen Wert in eine Variable zu extrahieren:

  1. Wählen Sie den zu extrahierenden Wert aus.

  2. Wählen Sie das Glühbirnensymbol aus, oder drücken Sie STRG+ . , um die Schnellkorrekturoptionen zu öffnen.

  3. Wählen Sie Wert extrahieren aus.

Screenshot: Schnelle Korrektur zum Extrahieren des Werts in eine Variable.

Schnelle Lösung: Definieren von Funktionen inline

Das Schnellkorrekturfeature kann auch verwendet werden, um eine vorhandene Funktion vor ihrer Verwendung inline zu definieren. Das Hinzufügen einer Inlinefunktionsdefinition kann hilfreich sein, um die Lesbarkeit und Wartbarkeit Ihrer Abfragen zu verbessern.

So zeigen Sie eine Funktionsdefinition an:

  1. Schreiben Sie den Funktionsnamen, und wählen Sie den Funktionsnamen aus.

  2. Wählen Sie das Glühbirnensymbol aus, oder drücken Sie STRG+ . , um die Schnellkorrekturoptionen zu öffnen.

  3. Um die Funktion inline zu definieren, wählen Sie Inline (Inlinefunktion) oder Inlinerekursiv (Inlinefunktion) aus.

Bewegter Screenshot der Schnellkorrekturfunktion für die Funktion

Verwenden von KQL-Tools

Mit den KQL-Tools auf der Symbolleiste können Sie eine Abfrage schnell duplizieren, die Befehlspalette öffnen oder auf die Dokumentation zugreifen.

So verwenden Sie KQL-Tools:

  1. Wählen Sie auf der Symbolleiste KQL-Tools aus.

  2. Wählen Sie aus Optionen wie Duplikatabfrage, Befehlspalette öffnen oder zeigen Sie auf Ressourcen , um auf Dokumentationslinks zuzugreifen. Diese Liste enthält Ressourcen wie das Spickzettel für KQL zu SQL, Tastenkombinationen und die KQL-Kurzreferenzdokumentation.

Screenshot der Option

Verwandte Inhalte