Abfragen von Daten in einem KQL-Abfrageset

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 für Daten aus einer KQL-Datenbank verwendet wird.

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

• Ein Arbeitsbereich mit einer Microsoft Fabric-fähigen Kapazität
• Eine KQL-Datenbank mit Bearbeitungsberechtigungen und Daten oder ein Azure Data Explorer-Cluster und eine Datenbank mit AllDatabaseAdmin-Berechtigungen.

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 einer KQL-Datenbank oder einer Datenbank aus einem Azure Data Explorer-Cluster zuordnen.

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

KQL-Datenbank

1. Öffnen Sie das KQL-Abfrageset.

2. Wählen Sie unter „Datenbank“" „V“ aus, um das Menü „Datenbankverbindungen“ zu erweitern.

   

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

4. Im daraufhin angezeigten OneLake-Datenhubfenster wählen Sie bitte eine KQL-Datenbank und anschließend „Auswählen“.

   

Azure Data Explorer-Cluster

1. Öffnen Sie das KQL-Abfrageset.

2. Wählen Sie unter „Datenbank“" „V“ aus, um das Menü „Datenbankverbindungen“ zu erweitern.

   

3. Wählen Sie unter „Quelle verbinden“ die Option Azure Data Explorer.

4. Geben Sie unter „URL verbinden“ den Cluster-URI ein.

   Um den Verbindungs-URI zu finden, wechseln Sie bitte zur Clusterressource im Azure-Portal. Der Verbindungs-URI ist der URI, der in der Übersicht angezeigt wird. Um einen kostenlosen Beispielcluster hinzuzufügen, geben Sie „help“ unter „URL verbinden“ ein.

   

5. Wählen Sie unter „Datenbank“ das Einblendmenü aus, um die Liste der Datenbanken in Ihrem Cluster zu erweitern, und wählen Sie dann eine Datenbank aus.

6. Wählen Sie Verbinden.

Unter dem Datenbanknamen wird eine Liste der Tabellen angezeigt, die dieser Datenbank 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-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.

   

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.

• Umbenennen einer Registerkarte: Wählen Sie das Bleistiftsymbol neben dem Namen der Registerkarte aus.
• 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.
• Ändern der vorhandenen Datenbankverbindung: Wählen Sie unter Datenbank die vorhandene Datenbankverbindung aus, um den Datenhub zu öffnen.

Abfrage kopieren

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

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

2. Wählen Sie Abfrage kopieren aus.

   

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

   Wichtig

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

   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 Freigabeaktion aus der obigen Tabelle aus.

4. Fügen Sie diese Informationen in einen beliebigen Editor wie Microsoft Word ein.

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 Abfragefenster die Registerkarte Verwalten aus.

   

2. Wählen Sie Ergebnisse 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, dem Ihr KQL-Abfrageset zugeordnet ist.

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

   

Nächster Schritt

Anpassen von Ergebnissen im Ergebnisraster des KQL-Abfragesets