Verwenden von Kusto.Explorer

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer

Kusto.Explorer ist eine Desktopanwendung, mit der Sie Ihre Daten mithilfe der Kusto-Abfragesprache in einer benutzerfreundlichen Benutzeroberfläche erkunden können. In diesem Artikel erfahren Sie, wie Sie Such- und Abfragemodi verwenden, Ihre Abfragen freigeben und Cluster, Datenbanken und Tabellen verwalten.

Suchmodus

Im Suchmodus können Sie mithilfe der Suchsyntax in einer oder mehreren Tabellen nach einem Begriff suchen.

1. Wählen Sie im Dropdownmenü "Abfrage" auf der Registerkarte "Start" die Option "Suchen++" aus.

2. Wählen Sie mehrere Tabellen aus.

3. Definieren Sie unter "Tabellen auswählen", welche Tabellen durchsucht werden sollen, und wählen Sie dann "OK" aus.

4. Geben Sie im Bearbeitungsfeld Ihren Suchbegriff ein, und wählen Sie "Gehe zu".

   Eine Wärmekarte des Tabellen-/Zeitfensterrasters zeigt an, welche Begriffe angezeigt werden und wo sie angezeigt werden.

   

5. Wählen Sie eine Zelle im Raster aus, und wählen Sie "Details anzeigen" aus, um die relevanten Einträge im Ergebnisbereich anzuzeigen.

   

Den Abfragemodus

Kusto.Explorer enthält einen leistungsfähigen Abfragemodus, mit dem Sie Inlineabfragen schreiben, bearbeiten und ausführen können. Der Abfragemodus enthält Syntaxmarkierung und IntelliSense, sodass Sie schnell Ihr Wissen über die Kusto-Abfragesprache hochfahren können.

In diesem Abschnitt wird das Ausführen grundlegender Abfragen in Kusto.Explorer und das Hinzufügen von Parametern zu Ihren Abfragen beschrieben.

Grundlegende Abfragen

Wenn Sie über Tabellenprotokolle verfügen, können Sie damit beginnen, sie zu untersuchen:

StormEvents | count 

Wenn sich der Cursor in dieser Zeile befindet, wird er grau gefärbt. Drücken Sie F5 , um die Abfrage auszuführen.

Hier sind einige weitere Beispielabfragen:

// Take 10 lines from the table. Useful to get familiar with the data
StormEvents | take 10 

// Filter by EventType == 'Flood' and State == 'California' (=~ means case insensitive) 
// and take sample of 10 lines
StormEvents 
| where EventType == 'Flood' and State =~ 'California'
| take 10

Weitere Informationen zum Kusto-Abfragesprache finden Sie unter Kusto-Abfragesprache.

Hinweis

Leere Zeilen im Abfrageausdruck können beeinflussen, welcher Teil der Abfrage ausgeführt wird.

Ist kein Text ausgewählt, wird davon ausgegangen, dass die Abfrage oder der Befehl durch leere Zeilen getrennt ist. Ist Text ausgewählt, wird der ausgewählte Text ausgeführt.

Clientseitige Abfrageparameterisierung

Hinweis

Es gibt zwei Arten von Abfrageparametertechniken in Kusto:

• Die sprachintegriert Abfrageparameterisierung wird serverseitig implementiert und soll von Anwendungen verwendet werden, die den Dienst programmgesteuert abfragen. Diese Methode wird in diesem Dokument nicht beschrieben.

• Clientseitige Abfrageparameterisierung ist nur ein Feature der Kusto.Explorer-Anwendung. Es entspricht der Verwendung von Zeichenfolgenersetzungsvorgängen für die Abfragen, bevor sie gesendet werden, um vom Dienst ausgeführt zu werden. Die Syntax ist nicht Teil der Abfragesprache selbst und kann nicht zum Senden von Abfragen an den Dienst mithilfe anderer Methoden als Kusto.Explorer verwendet werden.

Wenn Sie denselben Wert in mehreren Abfragen oder auf mehreren Registerkarten verwenden, ist es sehr unannelich, diesen Wert an jeder verwendeten Stelle zu ändern. Aus Gründen der Einfachheit unterstützt Kusto.Explorer Abfrageparameter. Abfrageparameter werden für Registerkarten freigegeben, sodass sie problemlos wiederverwendet werden können. Parameter werden durch {} eckige Klammern gekennzeichnet. Beispiel: {parameter1}.

Sie können vorhandene Abfrageparameter ganz einfach definieren und bearbeiten:

Sie können mehrere Sätze von Parametern haben (im Kombinationsfeld "Parameter festlegen "). Wählen Sie "Neu hinzufügen" oder "Aktuellen Löschen" aus, um die Liste der Parametersätze zu bearbeiten.

Freigeben von Abfragen und Ergebnissen

In Kusto.Explorer können Sie Abfragen und Ergebnisse per E-Mail freigeben. Sie können auch Deep-Links erstellen, die eine Abfrage im Browser öffnen und ausführen.

Freigeben von Abfragen und Ergebnissen per E-Mail

Kusto.Explorer bietet eine bequeme Möglichkeit, Abfragen und Abfrageergebnisse per E-Mail zu teilen.

1. Führen Sie Ihre Abfrage in Kusto.Explorer aus.

2. Wählen Sie auf der Registerkarte "Start " im Abschnitt "Freigeben " die Option "Abfrage" und "Ergebnisse" in die Zwischenablage aus (oder drücken Sie STRG+UMSCHALT+C).

   

   Kusto.Explorer kopiert Folgendes in die Zwischenablage:

   • Ihre Abfrage
   • Die Abfrageergebnisse (Tabelle oder Diagramm)
   • Die Verbindungsdetails für das Eventhouse und die Datenbank
   • Ein Link, mit dem die Abfrage automatisch erneut ausgeführt wird

3. Fügen Sie den Inhalt der Zwischenablage in eine neue E-Mail-Nachricht ein.

Deep-Linking-Abfragen

Sie können einen URI erstellen, der, wenn er in einem Browser geöffnet wird, kusto.Explorer lokal öffnet und eine bestimmte Abfrage für eine angegebene Kusto-Datenbank ausführt.

Hinweis

Aus Sicherheitsgründen ist deep-linking für Verwaltungsbefehle deaktiviert.

Erstellen eines Deep-Links

Die einfachste Möglichkeit zum Erstellen eines Deep-Links besteht darin, Ihre Abfrage in Kusto.Explorer zu erstellen und dann zum Kopieren der Abfrage (einschließlich des Deep-Links und der Ergebnisse) in die Zwischenablage zu verwenden Query and results to Clipboard . Sie können sie dann per E-Mail freigeben.

Beim Kopieren in eine E-Mail werden eine Reihe von auszuführenden Links in kleiner Schriftart angezeigt. Zum Beispiel:

Execute: [Web] [Desktop] [Web (Lens)] [Desktop (SAW)] https://trd-1234.kusto.fabric.microsoft.com

Der Weblink öffnet die Abfrage im Azure Data Explorer. Der Desktoplink ist der Deeplink. Sie öffnet die Abfrage in Kusto.Explorer und legt den Kontext entsprechend fest.

Wenn Sie den Link zu einer E-Mail-Nachricht verschieben und STRG+K drücken, wird die tatsächliche URL angezeigt.

Deep-Links und parametrisierte Abfragen

Sie können parametrisierte Abfragen mit Deep-Linking verwenden.

1. Erstellen einer Abfrage, die als parametrisierte Abfrage gebildet werden soll (z. B KustoLogs | where Timestamp > ago({Period}) | count. )

1. Geben Sie einen Parameter für jeden Abfrageparameter im URI an. Wenn Sie Ihren URI kopieren möchten, wählen Sie im KQL-Abfragebereich in Fabric "Abfrageverknüpfung>in Zwischenablage kopieren" aus.

2. Über den Link im Abfragebereich "Kusto.Explorer" hinaus.

Hinweis

Um sicherzustellen, dass Sie die Abfrage in Kusto.Explorer ausführen können, stellen Sie sicher, dass Sie eine Verbindung mit der Datenbank herstellen können, auf die in der Abfrage verwiesen wird.

Begrenzungen

Die Abfragen sind aufgrund von Browserbeschränkungen, HTTP-Proxys und Tools, die Links wie Microsoft Outlook überprüfen, auf ~2.000 Zeichen beschränkt. Die Einschränkung ist ungefähr, da sie von der Länge des Clusters und des Datenbanknamens abhängig ist. Weitere Informationen finden Sie unter https://support.microsoft.com/kb/208427.

Informationen zum Verringern der Wahrscheinlichkeit, dass die Zeichengrenze erreicht wird, finden Sie unter "Getting Shorter Links".

Der URI öffnet Kusto.Explorer und führt die angegebene Abfrage aus. Eine neue Registerkarte wird geöffnet, wenn bereits eine ausgeführte Instanz vorhanden ist.

Abrufen kürzerer Links

Abfragen können lang werden. Verwenden Sie die methode, die in der String Kusto.Data.Common.CslCommandGenerator.EncodeQueryAsBase64Url(string query) Kusto-Clientbibliothek verfügbar ist, um die Wahrscheinlichung zu verringern, dass die Abfrage die maximale Länge überschreitet. Diese Methode erzeugt eine kompaktere Version der Abfrage. Das kürzere Format wird auch von Kusto.Explorer erkannt.

<https://\BaseAddress>/groups/1234ab-cd55-6789-0123-e4567fg890hi/databases/01234abc-defg-6789-4567fg890hi?experience=power-bi&extensionScenario=openArtifact&query=1234AAAAAAAAAAAAAAAAAAA567890BBBBBBBBBBBBBBBBBBBB01234567890CCCCCCCCC1234AAAAAAAAAAAAA567890BBBBBBBBBBBBBBBBBBBBBBBB01234567890CCCCCCCCC%AB%AB

Die Abfrage wird komprimiert, indem die folgende Transformation angewendet wird:

 UrlEncode(Base64Encode(gzip(original query)))

Befehlszeilenargumente von Kusto.Explorer

Befehlszeilenargumente werden verwendet, um das Tool so zu konfigurieren, dass beim Start weitere Funktionen ausgeführt werden. Laden Sie beispielsweise ein Skript, und stellen Sie eine Verbindung mit einem Cluster her. Daher sind Befehlszeilenargumente kein Ersatz für kusto.Explorer-Funktionen.

Befehlszeilenargumente werden als Teil der URL übergeben, die zum Öffnen der Anwendung verwendet wird, ähnlich wie bei der Abfrage von Deep-Linking.

Befehlszeilenargumentsyntax

Kusto.Explorer unterstützt mehrere Befehlszeilenargumente in der folgenden Syntax (die Reihenfolge ist wichtig):

[LocalScriptFile] [QueryString]

Befehlszeilenargumente

Befehlszeilenargument	Beschreibung
LocalScriptFile	Der Name einer Skriptdatei auf Ihrem lokalen Computer, die die Erweiterung .kqlaufweisen muss. Wenn die Datei vorhanden ist, lädt Kusto.Explorer die Datei automatisch, wenn sie gestartet wird.
QueryString	Eine Zeichenfolge, die HTTP-Abfragezeichenfolgenformatierung verwendet. Diese Methode stellt weitere Eigenschaften bereit, wie in der folgenden Tabelle beschrieben.

Abfragezeichenfolgenargumente

Argument	Beschreibung
Auszuführende Abfrage
query	Die auszuführende Abfrage (gzipped, dann base64-codiert; siehe Abrufen kürzerer Links). Ohne Angabe dieses Parameters wird querysrc verwendet.
querysrc	Die URL einer Datei/eines Blobs, in der die Abfrage ausgeführt werden soll.
Verbindung zum Kusto-Cluster
uri	Die Verbindungszeichenfolge des Kusto-Clusters, mit dem eine Verbindung hergestellt werden soll.
name	Der Anzeigename der Verbindung zum Kusto-Cluster.
Verbindungsgruppe
path	Die URL einer herunterzuladenden Verbindungsgruppendatei (URL-codiert).
group	Der Name der Verbindungsgruppe.
filename	Die lokale Datei, die die Verbindungsgruppe enthält.

Beispiel

Um Kusto.Explorer mit einer Skriptdatei zu starten, die für die Kommunikation mit einer bestimmten Gruppe und Datenbank konfiguriert c:\temp\script.kql ist, verwenden Sie den folgenden Befehl:

Kusto.Explorer.exe c:\temp\script.kql "uri=https://<baseaddress>/groups/<GroupID>/databases/<DatabaseID>"

Verwalten von Datenbanken, Tabellen oder autorisierten Funktionsprinzipalen

Wichtig

Nur Administratoren können autorisierte Prinzipale in ihrem eigenen Bereich hinzufügen oder ablegen.

1. Um die Liste der autorisierten Prinzipale anzuzeigen, klicken Sie im Bereich "Verbindungen" mit der rechten Maustaste auf die Zielentität, und wählen Sie "Datenbankautorisierte Prinzipale verwalten" aus. (Sie können diese Option auch im Verwaltungsmenü auswählen.)

   

2. Wählen Sie "Prinzipal hinzufügen" aus, um einen autorisierten Prinzipal hinzuzufügen.

3. Geben Sie die Hauptdetails an, und wählen Sie dann "Prinzipal hinzufügen" aus.

   

4. Vergewissern Sie sich, dass Sie den autorisierten Prinzipal hinzufügen möchten.

   

Wenn Sie einen vorhandenen autorisierten Prinzipal ablegen möchten, wählen Sie "Drop"-Prinzipal aus, und bestätigen Sie die Aktion.

Zugehöriger Inhalt

• Tastenkombinationen für Kusto.Explorer
• Kusto.Explorer-Optionen
• Problembehandlung bei Kusto.Explorer
• Kusto.Explorer-Codefeatures
• Kusto-Abfragesprache (KQL)