Abfragen von Daten in einem KQL-Abfrageset

  • Artikel

In diesem Artikel erfahren Sie, wie Sie ein KQL-Abfrageset verwenden. Das KQL-Abfrageset ist das Element, das zum Ausführen von Abfragen sowie zum Anzeigen und Anpassen von Abfrageergebnissen aus verschiedenen Datenquellen verwendet wird, z. B. Eventhouse, KQL-Datenbank und anderen.

Das KQL-Abfrageset verwendet die Kusto-Abfragesprache Kusto Query Language, KQL zur Erstellung von Abfragen, und es unterstützt zudem viele SQL-Funktionen. Weitere Informationen zur Abfragesprache finden Sie in der Übersicht zur Kusto-Abfragesprache.

Voraussetzungen

Auswählen einer Datenbank

Abfragen werden im Kontext einer Datenbank ausgeführt. Sie können die zugeordnete Datenbank jederzeit ändern und die im Abfrage-Editor gespeicherten Abfragen beibehalten. Sie können Ihr KQL-Abfrageset mehreren Datenquellen unterschiedlicher Typen zuordnen, einschließlich einer KQL-Datenbank oder einer Datenbank aus einem Azure Data Explorer-Cluster.

Wählen Sie den Tab aus, der Ihrem gewünschten Datenbanktyp entspricht.

  1. Öffnen Sie das KQL-Abfrageset.

  2. Wählen Sie im Verbindungsbereich auf der linken Seite der Abfrageseite unter Explorer das Symbol V aus, um das Menü „Datenbankverbindungen“ zu erweitern.

    Screenshot des Datenbankmenüs mit einer Liste verbundener Datenbanken.

  3. Wählen Sie unter „Quelle verbinden“ den OneLake-Datenhub aus.

  4. Wählen Sie im daraufhin angezeigten Fenster OneLake-Datenhub eine KQL-Datenbank aus, um sie mit Ihrem KQL-Abfrageset zu verbinden, und wählen Sie dann Verbinden aus. Alternativ können Sie das Fenster OneLake-Datenhub schließen und das Menü +Datenquelle hinzufügen verwenden, um eine Verbindung mit einer anderen Datenquelle herzustellen.

Im Verbindungsbereich unter dem Datenbanknamen wird eine Liste der Tabellen angezeigt, die dieser Datenbank zugeordnet sind.

Interagieren mit Datenbanken mithilfe des Verbindungsbereichs

Im Verbindungsbereich können Sie Datenbanken durchsuchen und zwischen ihnen wechseln, die mit dem Abfrageset verbunden sind. Wählen Sie im Verbindungsbereich unter Datenbank das Symbol V aus, um das Menü „Datenbankverbindungen“ zu erweitern. Wählen Sie die Datenbank aus, die Sie erkunden möchten. Der Verbindungsbereich zeigt eine Aufschlüsselung der folgenden Elemente an, die in der ausgewählten Datenbank enthalten sind:

  • Tabellen
  • Materialisierte Sicht
  • Verknüpfungen
  • Funktionen

Im Verbindungsbereich können Sie untersuchen, welche Elemente in den einzelnen Abschnitten enthalten sind. Um das Aktionsmenü zu öffnen, zeigen Sie mit der Maus auf das Element, und wählen Sie das Menü Mehr [...] aus. Das Menü bietet folgende Optionen:

  • Aktualisieren von Daten
  • Datenprofil anzeigen
  • Einfügen zum Erstellen eines Skripts, um es in den Abfrage-Editor einzufügen
  • Delete

Für verschiedene Elementtypen stehen unterschiedliche Aktionen zur Verfügung.

Schreiben Sie eine Abfrage

Nachdem Sie nun mit Ihrer Datenquelle verbunden sind, können Sie Abfragen für Daten dieser Quelle ausführen. Das KQL-Abfrageset verwendet die Kusto-Abfragesprache (KQL), um Daten aus einer der Datenbanken abzufragen, auf die Sie Zugriff haben. Weitere Informationen zu KQL finden Sie unter Übersicht über die Kusto-Abfragesprache.

In den folgenden Beispielen werden Daten verwendet, die unter https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv öffentlich verfügbar sind.

  1. Schreiben oder kopieren Sie eine Abfrage im oberen Bereich des KQL-Abfragesets.

  2. Wählen Sie die Schaltfläche Ausführen aus, oder drücken Sie UMSCHALT+EINGABETASTE, um die Abfrage auszuführen.

    Die resultierende Abfrageausgabe wird im Ergebnisraster angezeigt, das unter dem Abfragebereich angezeigt wird. Beachten Sie das grüne Häkchen, das angibt, dass die Abfrage erfolgreich abgeschlossen wurde, und die Zeit für die Berechnung der Abfrageergebnisse.

    Screenshot: KQL-Abfrageset mit Abfrageergebnissen, wobei die Abfrage und der Ergebnisbereich hervorgehoben sind

Verwalten von Abfrageset-Registerkarten

Innerhalb eines KQL-Abfragesets können Sie mehrere Registerkarten erstellen. Jede Registerkarte kann einer anderen KQL-Datenbank zugeordnet werden. So können Sie Abfragen speichern, die sie später verwenden oder für andere Personen zur Zusammenarbeit bei der Datenuntersuchung freigeben können. Sie können auch die einer beliebigen Registerkarte zugeordnete KQL-Datenbank ändern. Dadurch können Sie dieselbe Abfrage für Daten in unterschiedlichen Zuständen ausführen.

Screenshot: Optionen für die Bearbeitungsregisterkarten im KQL-Abfrageset

  • Hinzufügen einer neuen Registerkarte: Wählen Sie das Plussymbol (+) rechts neben den vorhandenen Registerkarten aus. Verschiedene Registerkarten können mit verschiedenen Datenbanken verbunden werden.
  • Umbenennen einer Registerkarte: Wählen Sie das Bleistiftsymbol neben dem Namen der Registerkarte aus.
  • Registerkartenpositionen ändern: Ändern Sie Registerkartenpositionen mithilfe von Drag & Drop-Gesten.
  • Vorhandene Datenbankverbindung ändern: Wählen Sie unter Explorer die vorhandene Datenbankverbindung aus, um den Datenhub zu öffnen.

Auf der rechten Seite der Befehlsleiste gibt es ein Menü mit zusätzlichen Aktionen zum Verwalten von mehreren Registerkarten in Ihrem Abfrageset.

Screenshot des Menüs „Mehrere Registerkarten“ zum Verwalten mehrerer Registerkarten im KQL-Abfrageset.

Abfrage kopieren

Sie sollten die Abfragen, die Sie erstellen, kopieren und freigeben.

  1. Wählen Sie oben im Abfragezeitfenster die Registerkarte Start aus.

  2. Wählen Sie im Abfragebereich Abfrage kopieren aus.

    Screenshot: Registerkarte „Verwalten“ des KQL-Abfragesets mit den Optionen „Abfrage kopieren“ oder „Ergebnisse kopieren“ im Dropdownmenü

    In der folgenden Tabelle werden die verschiedenen Optionen zum Kopieren einer Abfrage beschrieben.

    Aktion Beschreibung
    Abfrage kopieren Kopieren Sie den Abfragetext.
    Link in Zwischenablage Kopieren Sie einen Deep-Link, der zum Ausführen der Abfrage verwendet werden kann.
    Link und Abfrage in Zwischenablage Kopieren Sie einen Link, mit dem die Abfrage und der Text der Abfrage ausgeführt werden können.
    Link, Abfrage und Ergebnisse in Zwischenablage Kopieren Sie einen Link, mit dem die Abfrage und ihr Text ausgeführt werden können.
    Ergebnisse kopieren Kopiert die Ergebnisse der Abfrage.

  3. Wählen Sie die gewünschte Aktion aus der obigen Tabelle aus.

  4. Fügen Sie diese Informationen ein, um sie zu bearbeiten oder freizugeben, z. B. in Microsoft Word, Microsoft Teams oder Outlook.

    Wichtig

    Der Benutzer, der den Abfragelink empfängt, benötigt Anzeigeberechtigungen für die zugrunde liegenden Daten, um die Abfrage- und Ansichtsergebnisse auszuführen.

Exportieren von Abfragedaten als CSV

Anstatt die Abfrageausgabe einfach zu kopieren und einzufügen, können Sie die Abfrageergebnisse auch exportieren.

Dabei handelt es sich um eine Methode zum einmaligen Exportieren einer CSV-Datei mit den Abfrageergebnissen.

  1. Wählen Sie oben im Abfragezeitfenster die Registerkarte Start aus.

    Screenshot: Registerkarte „Start“ der KQL-Abfragesprache mit der hervorgehobenen Option „Ergebnisse in CSV exportieren“.

  2. Wählen Sie im Abfragebereich In CSV exportieren aus.

  3. Speichern Sie die CSV-Datei lokal.

Löschen des KQL-Abfragesets

So löschen Sie das KQL-Abfrageset:

  1. Wählen Sie den Arbeitsbereich aus, in dem sich Ihr KQL-Abfrageset befindet.

  2. Bewegen Sie den Mauszeiger über das KQL-Abfrageset, das Sie löschen möchten. Wählen Sie Mehr [...] und dann Löschen aus.

    Screenshot: Vorgehensweise beim Löschen des KQL-Abfragesets im Microsoft Fabric-Arbeitsbereich.

Nächster Schritt

Anpassen von Ergebnissen im Ergebnisraster des KQL-Abfragesets