Freigeben über

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 Datenquelle

Abfragen werden im Kontext einer Datenquelle ausgeführt. Sie können die zugeordnete Datenquelle 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 Datenquelle aus einem Azure Data Explorer-Cluster.

Wählen Sie die Registerkarte aus, die dem gewünschten Datenquellentyp entspricht.

  1. Öffnen Sie das KQL-Abfrageset.

  2. Verwenden Sie im Bereich auf der linken Seite der Abfrageseite unter Explorer und der Suchleiste den Datenbankumschalter, um das Menü „Datenquellenverbindungen“ aufzuklappen.

    Screenshot des Datenquellenmenüs mit einer Liste verbundener Datenquellen.

  3. Wählen Sie Datenquelle hinzufügen und dann 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.

Unterhalb des Datenquellennamens wird eine Liste der Tabellen angezeigt, die dieser Datenquelle zugeordnet sind.

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 Queryset verwendet die Kusto Query Language (KQL), um Daten aus einer der Datenquellen 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

Interagieren mit Datenquellen

Mit dem Datenquellen-Explorer können Sie zwischen den Datenquellen wechseln, die mit der Abfrageset-Registerkarte verbunden sind, in der Sie sich befinden.

Oben im Bereich des Datenquellen-Explorers können Sie unter Explorer die Suchleiste verwenden, um nach einer bestimmten Datenquelle zu suchen. Sie können den Datenbankumschalter auch unter der Suchleiste verwenden, um das Menü „Datenquellenverbindungen“ aufzuklappen. Wählen Sie die Datenquelle aus, die Sie verwenden möchten. Wenn der Name der Registerkarte noch nicht zuvor bearbeitet wurde, wird er automatisch nach der Datenquelle benannt.

Screenshot, der zeigt, wie Sie mithilfe der Suchleiste und des Datenbankwechsels im Explorer-Bereich zwischen Datenquellen wechseln.

Der Bereich des Datenquellen-Explorers besteht aus zwei Abschnitten. Im oberen Abschnitt werden alle Elemente in der Datenquelle aufgelistet, und im unteren Abschnitt werden alle verfügbaren Datenquellen im Abfragesatz angezeigt.

Elemente in der Datenquelle

Im oberen Abschnitt des Datenquellen-Explorers werden alle Elemente angezeigt, die in der von Ihnen verwendeten Datenquelle enthalten sind.

  • Tabellen
  • Materialisierte Ansicht
  • Verknüpfungen
  • Funktionen

Wählen Sie den Pfeil > links neben dem Element aus, das Sie erweitern möchten. Sie können einen Drilldown ausführen, um weitere Details anzuzeigen, indem Sie den Pfeil > links von Elementen in nachfolgenden Listenebenen auswählen. Wählen Sie z. B. unter Tabellenden Pfeil > links neben einer Tabelle aus, um die Liste der Spalten in dieser Tabelle anzuzeigen.

Um das Aktionsmenü zu öffnen, zeigen Sie auf ein Element in der erweiterten Liste und wählen Sie das Weitere Aktionen Menü [...]. Das Menü zeigt die folgenden Optionen:

  • Datenbank aktualisieren
  • Datenprofil anzeigen
  • Einfügen: um ein Skript zu erstellen und zu kopieren
  • Abrufen von Daten: Hinzufügen einer neuen Datenquelle
  • Ein Dashboard erstellen
  • Tabelle löschen

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

Screenshot mit dem Explorer-Bereich, wie Sie die Liste der Elemente in Ihrer Datenquelle erweitern und wo das Menü

Verfügbare Datenquellen

Im unteren Abschnitt des Datenquellen-Explorers werden alle verfügbaren Datenquellen angezeigt, die dem Queryset hinzugefügt wurden.

Zum Öffnen des Aktionsmenüs zeigen Sie mit dem Mauszeiger auf den Namen der Datenquelle, dann wählen Sie das Weitere Aktionen Menü [...]. Das Menü zeigt die folgenden Optionen:

  • Datenbank aktualisieren
  • Verwenden dieser Datenbank: Wechseln Sie auf die aktuelle Registerkarte, um diese Datenquelle zu verwenden
  • Abfrage in einem neuen Tab: Öffnen Sie diese Datenquelle in einem neuen Tab innerhalb des Abfragesets.
  • Quelle entfernen: Entfernt alle Datenbanken in dieser Datenquelle.
  • Datenbank entfernen: Entfernt nur die ausgewählte Datenbank.

Screenshot, der den unteren Abschnitt des Explorer-Bereichs zeigt, in dem alle Datenquellen aufgeführt sind, die Ihrem Abfrageset hinzugefügt wurden.

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 Liste 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.

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 mit einer beliebigen Registerkarte verknüpfte KQL-Datenbank ändern, sodass Sie dieselbe Abfrage für Daten in verschiedenen Datenbanken ausführen können.

Zur Verwaltung von Registerkarten stehen Ihnen folgende Möglichkeiten zur Verfügung:

  • Ändern Sie die vorhandene Datenquellenverbindung: Verwenden Sie unter Explorer und der Suchleiste den Datenbankumschalter, um das Menü "Datenquellenverbindungen" zu erweitern.
  • Umbenennen einer Registerkarte: Wählen Sie neben dem Namen der Registerkarte das Bleistiftsymbol aus.
  • Hinzufügen einer neuen Registerkarte: Wählen Sie rechts neben den vorhandenen Registerkarten das Plussymbol (+) aus. Verschiedene Registerkarten können mit verschiedenen Datenquellen verbunden werden.
  • Weitere Aktionen: Auf der rechten Seite der Befehlsleiste gibt es ein Registerkartenmenü mit zusätzlichen Aktionen zum Verwalten von mehreren Registerkarten in Ihrem Abfrageset.
  • Ändern von Registerkartenpositionen: Verwenden Sie Drag-and-Drop-Funktionen.

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

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