Freigeben über

Verwenden von Parametern in Azure Data Explorer-Dashboards

  • Artikel

Parameter werden als Bausteine für Filter in Azure Data Explorer-Dashboards verwendet. Sie werden im Dashboardbereich verwaltet und können zu Abfragen hinzugefügt werden, um die Daten zu filtern, die von dem zugrunde liegenden visuellen Element dargestellt werden. Eine Abfrage kann einen oder mehrere Parameter verwenden.

Dieses Dokument beschreibt die Erstellung und Verwendung von Parametern sowie verknüpften Filtern in Dashboards. Mit Parametern können visuelle Dashboard-Elemente gefiltert werden. Wählen Sie dazu entweder Parameterwerte auf der Filterleiste aus, oder verwenden Sie Kreuzfilter.

Die in diesem Artikel verwendeten Abfragebeispiele basieren auf der StormEvents Tabelle im Beispielkatalog.

Hinweis

Die Parameterverwaltung ist für Dashboard-Editoren im Bearbeitungsmodus verfügbar.

Voraussetzungen

Anzeigen von Parameterlisten

Um die Liste aller Dashboardparameter anzuzeigen, wählen Sie oben im Dashboard die Schaltfläche "Parameter " aus.

Screenshot der Schaltfläche

Erstellen eines Parameters

Zum Erstellen eines Parameters:

  1. Wechseln sie vom Anzeigemodus zum Bearbeitungsmodus .

    Screenshot der Bearbeitungsschaltfläche am oberen Rand des Dashboards.

  2. Wählen Sie oben im Dashboard die Schaltfläche "Parameter " aus.

    Screenshot der Schaltfläche

  3. Wählen Sie oben im rechten Bereich die Schaltfläche +Neuer Parameter aus.

  4. Füllen Sie die relevanten Eigenschaften für Ihren Parameter aus.

Unterstützte Eigenschaften

Konfigurieren Sie im Bereich "Parameter hinzufügen" die folgenden Eigenschaften:

Feld Beschreibung
Bezeichnung Der Name des Parameters, der auf dem Dashboard oder der Bearbeitungskarte angezeigt wird.
Parametertyp Einer der folgenden Parameter:
  • Single selection (Einfachauswahl): Im Filter kann als Eingabe für den Parameter nur ein Wert ausgewählt werden.
  • Mehrfachauswahl: Im Filter können als Eingaben für den Parameter mehrere Werte ausgewählt werden.
  • Zeitbereich: Ermöglicht das Erstellen zusätzlicher Parameter, um die Abfragen und Dashboards basierend auf der Zeit zu filtern. Jedes Dashboard verfügt standardmäßig über eine Zeitbereichsauswahl.
  • Freier Text: Im Filter sind keine Werte aufgefüllt. Der Benutzer kann einen Wert eingeben oder einen Wert kopieren und in das Textfeld einfügen. Der Filter speichert die zuletzt verwendeten Werte.
Variablenname Der Name des Parameters, der in der Abfrage verwendet werden soll. Tipp: Das Präfix von Variablennamen mit einem unverwechselbaren Zeichen, z. B. einem Unterstrichzeichen (_), erleichtert das Auffinden beim Schreiben von Abfragen.
Datentyp Der Datentyp des Parameterwerts.
Auf Seiten anzeigen Wählen Sie die Seiten aus, auf denen dieser Parameter angezeigt wird. Mit der Option Alle auswählen wird der Parameter auf allen Seiten angezeigt.
Quelle Die Quelle der Parameterwerte:
  • Feste Werte: Manuell eingefügte statische Filterwerte.
  • Query (Abfrage): Dynamisch über eine KQL-Abfrage eingefügte Werte.
Standardwert Der Standardwert des Filters. Der Filter beginnt beim ersten Rendern des Dashboards immer mit dem Standardwert.
Add a „Select all“ value („Alle auswählen“ hinzufügen) Gilt nur für Parametertypen mit Einfach- und Mehrfachauswahl. Wird verwendet, um Daten für alle Parameterwerte abzurufen. Dieser Wert sollte in die Abfrage integriert werden, um die Funktionalität bereitzustellen. Weitere Beispiele zum Erstellen solcher Abfragen finden Sie unter Verwenden des abfragebasierten Mehrfachauswahlparameters.

Parameter verwalten

Nachdem Sie Parameter in der oberen Leiste ausgewählt haben, können Sie die Liste der vorhandenen Parameter anzeigen. Wählen Sie in jeder Parameterkarte das Stift-Widget aus, um den Parameter zu bearbeiten, oder wählen Sie das Menü "Mehr [...]" aus, um den Parameter zu duplizieren, zu löschen oder zu verschieben.

Die folgenden Indikatoren können auf der Karte „Parameter“ angezeigt werden:

  • Anzeigename des Parameters
  • Variablennamen
  • Anzahl der Abfragen, in denen der Parameter verwendet wurde
  • Seiten, an die der Parameter angeheftet ist

Die Parameterkarten können durch Ziehen und Ablegen oder mithilfe der Option "Verschieben nach > " angeordnet und die neue Position ausgewählt werden.

Screenshot der Beispielparameter Karten.

Verwenden von Parametern in Ihrer Abfrage

Ein Parameter muss in der Abfrage verwendet werden, damit der Filter auf das visuelle Element diese Abfrage anwendbar wird. Nachdem Sie die Parameter definiert haben, können Sie sie auf der Seite Abfrage > „Filtern“ auf der oberen Leiste und im Abfrage-IntelliSense sehen.

Hinweis

Wenn der Parameter nicht in der Abfrage verwendet wird, bleibt der Filter inaktiv. Nachdem der Parameter der Abfrage hinzugefügt wurde, wird der Filter aktiv.

Parametertypen

Es werden mehrere Dashboard-Parametertypen unterstützt, wie folgt:

In den folgenden Beispielen wird beschrieben, wie Parameter in einer Abfrage für verschiedene Parametertypen verwendet werden.

Standardparameter „Zeitbereich“

Jedes Dashboard verfügt standardmäßig über einen Parameter Zeitbereich. Er wird nur dann im Dashboard als Filter angezeigt, wenn er in einer Abfrage verwendet wird. Verwenden Sie die Parameterschlüsselwörter _startTime und _endTime, um den Standardparameter „Zeitbereich“ in einer Abfrage zu verwenden, wie im folgenden Beispiel gezeigt:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Nach dem Speichern wird der Zeitbereichsfilter im Dashboard angezeigt. Er kann jetzt zum Filtern der Daten auf der Karte verwendet werden. Sie können Ihr Dashboard filtern, indem Sie aus der Dropdownliste auswählen: Zeitbereich (letzte x Minuten/Stunden/Tage) oder einen benutzerdefinierten Zeitbereich.

Screenshot, der zeigt, wie Sie mithilfe eines benutzerdefinierten Zeitraums filtern.

Parameter mit festem Wert für Einfachauswahl

Parameter mit festem Wert basieren auf vom Benutzer angegebenen, vordefinierten Werten. Das folgende Beispiel zeigt Ihnen, wie Sie einen Parameter mit festem Wert für Einfachauswahl erstellen.

Erstellen eines Parameters mit festem Wert für Einfachauswahl

  1. Wählen Sie Parameter aus, um den Bereich Parameter zu öffnen, und wählen Sie Neuer Parameter aus.

  2. Füllen Sie die Details wie folgt aus:

    • Bezeichnung: Ereignistyp

    • Parametertyp: Einzelauswahl

    • Variablenname: _eventType

    • Datentyp: Zeichenfolge

    • Als Dashboardfilter anheften: aktiviert

    • Quelle: Feste Werte

      Verwenden Sie in diesem Beispiel folgende Werte:

      Wert Anzeigename des Parameters
      Sturm Sturm
      Hagel Hagel
      Überschwemmung Überschwemmung
      Dürre Dürre
      Winterwetter Winterwetter

    • Fügen Sie einen Alle auswählen-Wert hinzu: Deaktiviert

    • Standardwert: Sturm

  3. Wählen Sie Fertig aus, um den Parameter zu erstellen.

Der Parameter kann im Seitenbereich Parameter angezeigt werden, wird aber zurzeit in keinen visuellen Elementen verwendet.

Verwenden eines Parameters mit festem Wert für Einfachauswahl

  1. Führen Sie eine Beispielabfrage mit dem neuen Parameter "Event TypTope " mithilfe des _eventType Variablennamens aus:

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType == _eventType
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

    Der neue Parameter wird in der Parameterliste am oberen Rand des Dashboards angezeigt.

  2. Wählen Sie unterschiedliche Werte aus, um die visuellen Elemente zu aktualisieren.

    Bildschirmpräsentation mit dem Ergebnis der fünf obersten Zustände.

Parameter mit festem Wert für Mehrfachauswahl

Parameter mit festem Wert basieren auf vom Benutzer angegebenen, vordefinierten Werten. Das folgende Beispiel zeigt, wie Sie einen Parameter mit festem Wert für Mehrfachauswahl erstellen und verwenden.

Erstellen eines Mehrfachauswahlparameters mit festen Werten

  1. Wählen Sie Parameter aus, um den Bereich Parameter zu öffnen, und wählen Sie Neuer Parameter aus.

  2. Geben Sie die Details, wie unter Verwenden eines Parameters mit festem Wert für Einfachauswahl beschrieben, mit den folgenden Änderungen ein:

    • Bezeichnung: Ereignistyp
    • Parametertyp: Mehrfachauswahl
    • Variablenname: _eventType

  3. Wählen Sie Fertig aus, um den Parameter zu erstellen.

Die neuen Parameter können im Seitenbereich Parameter angezeigt werden, werden aber zurzeit in keinen visuellen Elementen verwendet.

Verwenden des Parameters mit festem Wert für Mehrfachauswahl

  1. Führen Sie eine Beispielabfrage mit dem neuen Parameter Ereignistyp aus, indem Sie die Variable _eventType verwenden:

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

    Der neue Parameter wird in der Parameterliste am oberen Rand des Dashboards angezeigt.

  2. Wählen Sie einen oder mehrere unterschiedliche Werte aus, um die visuellen Elemente zu aktualisieren.

    Screenshot, der zeigt, wie mehrere Ereignistypen ausgewählt werden.

Abfragebasierte Parameter für Einfachauswahl

Abfragebasierte Parameterwerte werden beim Laden des Dashboards durch Ausführen der Parameterabfrage abgerufen. Im folgenden Beispiel wird gezeigt, wie Sie einen abfragebasierten Parameter für Einfachauswahl erstellen und verwenden.

Erstellen eines abfragebasierten Parameters für Einfachauswahl

  1. Wählen Sie Parameter aus, um den Bereich Parameter zu öffnen, und wählen Sie Neuer Parameter aus.

  2. Geben Sie die Details, wie unter Verwenden eines Parameters mit festem Wert für Einfachauswahl beschrieben, mit den folgenden Änderungen ein:

    • Bezeichnung: Status

    • Variablenname: _state

    • Quelle: Abfrage

    • Datenquelle: StormEventsSample

    • Wählen Sie Abfrage bearbeiten aus, und geben Sie die folgende Abfrage ein. Wählen Sie Fertig aus.

      StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents
| project State

    • Wert: Status

    • Anzeigename: Status

    • Standardwert: Wählen Sie einen Standardwert aus.

  3. Wählen Sie Fertig aus, um den Parameter zu erstellen.

Verwenden des abfragebasierten Parameters für Einfachauswahl

  1. Die folgende Beispielabfrage mit dem neuen Parameter Status verwendet die Variable _state:

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| where State == _state
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

    Der neue Parameter wird in der Parameterliste am oberen Rand des Dashboards angezeigt.

  2. Wählen Sie unterschiedliche Werte aus, um die visuellen Elemente zu aktualisieren.

Abfragebasierte Parameter für Mehrfachauswahl

Abfragebasierte Parameterwerte werden zum Zeitpunkt des Ladens des Dashboards durch Ausführen der vom Benutzer angegebenen Abfrage abgeleitet. Im folgenden Beispiel wird gezeigt, wie Sie einen abfragebasierten Parameter für Mehrfachauswahl erstellen:

Abfragebasierten Parameter für Mehrfachauswahl erstellen

  1. Wählen Sie Parameter aus, um den Bereich Parameter zu öffnen, und wählen Sie + Neuer Parameter aus.

    1. Geben Sie die Details, wie unter Verwenden eines Parameters mit festem Wert für Einfachauswahl beschrieben, mit den folgenden Änderungen ein:
    • Bezeichnung: Status
    • Parametertyp: Mehrfachauswahl
    • Variablenname: _state

  3. Wählen Sie Fertig aus, um den Parameter zu erstellen.

Verwenden eines abfragebasierten Parameters für Mehrfachauswahl

  1. Die folgende Beispielabfrage verwendet den neuen Parameter Status unter Verwendung der Variablen _state.

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| where State in (_state) or isempty(_state)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

    Hinweis

    In diesem Beispiel wird die Option Alle auswählen verwendet, indem mit der Funktion isempty() auf leere Werte überprüft wird.

    Der neue Parameter wird in der Parameterliste am oberen Rand des Dashboards angezeigt.

  2. Wählen Sie einen oder mehrere unterschiedliche Werte aus, um die visuellen Elemente zu aktualisieren.

Freitext-Parameter

Parameter für freien Text enthalten keine Werte. Sie ermöglichen Ihnen die Eingabe eines eigenen Werts.

Erstellen eines Parameters für freien Text

  1. Wählen Sie Parameter aus, um den Bereich Parameter zu öffnen, und wählen Sie + Neuer Parameter aus.

  2. Füllen Sie die Details wie folgt aus:

    • Bezeichnung: Status
    • Parametertyp: Freier Text
    • Variablen-Name: _Status
    • Datentyp: Zeichenfolge
    • Standardwert: Kein Standardwert

Einen freien Text-Parameter verwenden

  1. Führen Sie eine Beispielabfrage mit dem neuen Parameter Status aus, indem Sie den Variablennamen _state verwenden:

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| where State contains _state
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Datenquellen Parameter

Nachdem Sie Ihrem Dashboard Datenquellen hinzugefügt haben, können Sie einen Parameter erstellen, der eine oder mehrere der verfügbaren Datenquellen auswählt. Der Parameter kann nicht in Kacheln und mit anderen Parametern verwendet werden.

Erstellen eines Datenquellen-Parameters

  1. Wählen Sie Parameter aus, um den Bereich Parameter zu öffnen, und wählen Sie + Neuer Parameter aus.

  2. Füllen Sie die Details wie folgt aus:

    • Bezeichnung: Quelle
    • Parametertyp: Datenquelle
    • Auf Seiten anzeigen: Alle auswählen
    • Werte: Alle auswählen
    • Standardwert: StormEventsSample

  3. Wählen Sie Fertig aus.

Der neue Parameter wird nun in der Parameterliste am oberen Rand des Dashboards angezeigt.

Verwenden eines Datenquellen-Parameters

  1. Navigieren Sie zur Abfrage einer neuen oder vorhandenen Kachel.

  2. Wählen Sie in "Quelle" den Namen des neuen Parameters unter " Datenquellenparameter" aus. Wählen Sie für den oben erstellten Parameter "Cluster" aus.

  3. Wählen Sie Änderungen übernehmen aus.

  4. Verwenden Sie den Parameter Cluster , um die Datenquelle für diese verbundene Abfrage zu ändern.

Parameter für Kreuzfilter

Mit Kreuzfiltern können Sie einen Wert in einem visuellen Element auswählen, und alle visuellen Dashboardelemente (etwa Linien- oder Punktdiagramme) werden gefiltert, um nur zugehörige Daten anzuzeigen. Die Verwendung von Kreuzfiltern erzielt das gleiche Ergebnis wie das Auswählen des entsprechenden Werts für den Parameter in der Parameterliste oben auf dem Dashboard.

Definieren von Kreuzfiltern

Um einen Kreuzfilter zu erstellen, müssen Sie ihn im visuellen Element zulassen und den Parameter angeben, der zum Filtern der Daten verwendet wird.

  1. Navigieren Sie zur Abfrage der Kachel, in der Sie Kreuzfilter hinzufügen möchten.

  2. Wählen Sie Visuelles Element aus.

  3. Wählen Sie im rechten Bereich Interaktionen aus, und aktivieren Sie dann Kreuzfilter.

  4. Geben Sie optional den Interaktionstyp an. Der Standardwert ist Punkt, an dem Sie einen Wert im visuellen Element auswählen können. Wenn Sie einen Wertebereich auswählen möchten, z. B. in einem Zeitdiagramm, wählen Sie Bewegen aus.

  5. Geben Sie sowohl die Spalte an, die zum Bereitstellen des Werts verwendet wird, als auch einen Parameter, der zum Filtern der Abfrage verwendet wird.

    Wichtig

    Die Spalte und der Parameter müssen denselben Datentyp haben.

Screenshot der visuellen Seite

Interagieren mit Ihren Daten mithilfe von Kreuzfiltern

Nachdem der Kreuzfilter definiert wurde, können Sie ihn für die Interaktion mit Ihren Daten verwenden. In visuellen Elementen, in denen Sie Kreuzfilter definiert haben, können Sie Datenpunkte auswählen und ihre Werte verwenden, um die aktuellen Dashboardseiten zu filtern. Wählen Sie für visuelle Tabellenelemente Datenpunkte aus, indem Sie mit der rechten Maustaste auf die entsprechende Zelle klicken und dann im Kontextmenü Kreuzfilter auswählen.

Screenshot einer visuellen Tabelle mit der Kontextmenüoption

Sie können den Kreuzfilter zurücksetzen, indem Sie oben in dem visuellen Element, in dem er aktiviert wurde, die Option Zurücksetzen auswählen.

Screenshot der Tabelle visuelle Elemente, der die Rücksetztaste anzeigt.

Verwenden von Drillthroughs als Dashboardparameter

Mit Drillthrough können Sie einen Wert in einem Bildmaterial auswählen und ihn zum Filtern des Bildmaterials auf einer Zielseite in demselben Dashboard verwenden. Wenn die Zielseite geöffnet wird, wird der Wert in den relevanten Filtern voreingestellt. Die visuellen Darstellungen auf der Seite, z. B. Linien- oder Punktdiagramme, werden so gefiltert, dass nur verwandte Daten angezeigt werden.

Definieren eines Drillthrough

Um einen Drillthrough zu erstellen, müssen Sie ihn zunächst im Bildmaterial aktivieren und dann einen oder mehrere Drillthroughs nach Bedarf hinzufügen.

  1. Bearbeiten Sie das visuelle Element, in dem Sie ein Drillthrough hinzufügen möchten. Stellen Sie sicher, dass die Registerkarte Visuelles Objekt ausgewählt ist.

  2. Wählen Sie im rechten Bereich Interaktionen aus, und aktivieren Sie dann Drillthrough.

    Screenshot der Drillthrough-Seite mit der Option

  3. Wählen Sie unter Drillthrough die Option Neu erstellen aus, und geben Sie die folgenden Informationen an. Wählen Sie optional Weiteres Paar hinzufügen aus, um mehrere Parameter für eine Zielseite hinzuzufügen. Wiederholen Sie diesen Schritt, um Drillthroughs zu anderen Seiten im aktuellen Dashboard mit anderen Parametern hinzuzufügen.

    Feld Beschreibung
    Ziel-Seite Eine oder mehrere Zielseiten, die mit den definierten Parametern drillen können.
    Spalte Die Spalte des Abfrageergebnisses, die als Wert für einen Parameter auf der Zielseite verwendet werden soll.
    Parameter Der Parameter, der zum Filtern von Bildmaterial auf der Zielseite anhand des Spaltenwerts verwendet wird.
    Hinweise Optionale kurze Beschreibung.

    Wichtig

    Spalte und der Parameterpaare müssen denselben Datentyp haben.

Interaktion mit Ihren Daten durch Drillthroughs

Sobald Drillthroughs definiert sind, können Sie sie zur Interaktion mit Ihren Daten verwenden. Um dies zu tun, klicken Sie in visuelle Objekte oder Tabellen, in denen Sie ein Drillthrough definiert haben, klicken Sie mit der rechten Maustaste auf einen Datenpunkt, und wählen Sie dann Drillthrough zu>Zielseite aus. Die Werte aus dem Datenpunkt werden als Parameter verwendet, um die visuellen Objekte auf der Zielseite zu filtern.

Screenshot eines visuellen Dashboards mit der Drillthrough-Interaktion.

Um zur Quellseite zurückzukehren, wählen Sie oben rechts auf der Zielseite die Option "Zurücksetzen" aus. Alle vom Drillthrough zugewiesenen Filter werden zurückgesetzt.

Verwenden der Filtersucher für Filter für Einfach- und Mehrfachauswahl

Geben Sie in den Filtern für Einfach- und Mehrfachauswahl den gewünschten Wert ein. Der Filter wird aktualisiert, um nur die Werte anzuzeigen, die dem Suchbegriff entsprechen.

Zugehöriger Inhalt