Freigeben über


Schreiben Kusto-Abfragesprache Abfragen in der Azure Data Explorer-Web-Benutzeroberfläche

Der Web-UI-Abfrage-Editor für Azure Data Explorer bietet verschiedene Features, mit denen Sie Kusto-Abfragesprache (KQL)-Abfragen schreiben können. Einige dieser Features umfassen integrierte KQL IntelliSense und AutoVervollständigen, Inlinedokumentation und Popups für schnelle Fehlerkorrekturen. In diesem Artikel wird hervorgehoben, was Sie beim Schreiben von KQL-Abfragen in der Web-UI wissen sollten.

KQL IntelliSense und AutoVervollständigen

Der Abfrage-Editor verfügt über integrierte KQL IntelliSense, die Kontextvorschläge für Funktionen und Operatoren bietet, und AutoVervollständigen, mit dem 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 aktiviert, Stellt Dropdownoptionen für Entitäten, Operatoren, Funktionen und vieles mehr dar. Wechseln Sie mit den Pfeiltasten auf der Tastatur zwischen diesen Optionen, und wählen Sie eine option 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.

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

Dokumentation inline 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. Wählen Sie das Pfeilsymbol nach rechts aus, um eine Inlinevorschau der Dokumentation zu öffnen.

    Screenshot der Dokumentation des Inline-KQL-Operators.

    Hinweis

    Die Vorschau bleibt aktiv, bis Sie die Sitzung schließen oder 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. Das Feature "Schnellkorrektur" kann verwendet werden, um die Abfrage basierend auf diesen Vorschlägen und Warnungen anzupassen.

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

  1. Zeigen Sie mit der Maus auf den Ausdruck, um den Vorschlag oder die Warnung anzuzeigen.

  2. Wählen Sie "Schnellkorrektur" aus, um die verfügbaren Schnellkorrekturoptionen anzuzeigen.

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

Screenshot der Schnellkorrektur basierend auf dem Leistungsvorschlag.

Tipp

Informationen zum Anpassen der vorschläge und Warnungen, die Sie erhalten, finden Sie unter Anpassen der Einstellungen in der Azure Data Explorer-Web-UI.

Schnellkorrektur: Extrahieren eines Werts in eine Variable

Das Feature "Schnellkorrektur" 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 "Extrahieren"-Wert aus.

Screenshot der Schnellkorrektur zum Extrahieren von Wert in Variable.

Schnellkorrektur: Definieren von Funktionen inline

Das Feature "Schnellkorrektur" kann auch verwendet werden, um eine vorhandene Funktion inline zu definieren, bevor sie verwendet wird. Das Hinzufügen einer Inlinefunktionsdefinition kann hilfreich sein, um die Lesbarkeit und Verwendbarkeit Ihrer Abfragen zu verbessern.

So zeigen Sie eine Funktionsdefinition an:

  1. Schreiben sie, 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 Inline recursiv (Inlinefunktion) aus.

Verschieben des Screenshots des Features

Verwenden von KQL-Tools

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

So verwenden Sie KQL-Tools:

  1. Wählen Sie in 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 KQL zu SQL-Spickzettel, Tastenkombinationen und KQL-Kurzübersichtsdokumentation.

Screenshot der KQL-Tools-Option in der Web-UI-Symbolleiste.