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.

In diesem Dokument wird die Erstellung und Verwendung von Parametern und verknüpften Filtern in Dashboards beschrieben. Parameter können verwendet werden, um Dashboard Visuals entweder durch Auswählen von Parameterwerten in der Filterleiste oder mithilfe von Querfiltern zu filtern.

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

Hinweis

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

Voraussetzungen

Anzeigen von Parameterlisten

Um die Liste aller Dashboard Parameter anzuzeigen, klicken Sie oben auf der Dashboard auf die Schaltfläche Parameter.

Screenshot der Schaltfläche

Erstellen eines Parameters

So erstellen Sie einen Parameter:

  1. Wechseln Sie vom Anzeigen zum Bearbeitungsmodus .

    Screenshot der Bearbeitungsschaltfläche oben auf Dashboard.

  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. Geben Sie die relevanten Eigenschaften für Ihren Parameter ein.

Unterstützte Eigenschaften

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

Feld Beschreibung
Label 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 Unterscheidungszeichen, z. B. einem Unterstrich (_), erleichtert die Suche 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 für das Erstellen solcher Abfragen finden Sie unter Verwenden des auf Mehrfachauswahlabfragen basierenden Parameters.

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 jedem parameter Karte das Stiftwidget aus, um den Parameter zu bearbeiten, oder wählen Sie das Menü Mehr [...] zu Duplizieren, Löschen oder Verschieben des Parameters aus.

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 per Drag-and-Drop oder mithilfe der Option Verschieben nach > sortiert werden und die neue Position auswählen.

Screenshot: Beispielparameterkarten

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 in der Abfrage nicht verwendet wird, bleibt der Filter inaktiv. Nachdem der Parameter der Abfrage hinzugefügt wurde, wird der Filter aktiv.

Parametertypen

Mehrere Dashboard Parametertypen werden wie folgt unterstützt:

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

Standardzeitbereichsparameter

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 einen Dropdowneintrag auswählen: Zeitbereich (letzte x Minuten/Stunden/Tage) oder einen Benutzerdefinierten Zeitbereich.

Screenshot: Filtern mithilfe eines benutzerdefinierten Zeitbereichs

Festwertparameter mit Einzelauswahl

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 Single-Selection-Parameters 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 folgt ein:

    • Bezeichnung: Ereignistyp

    • Parametertyp: Einfachauswahl

    • Variablenname: _eventType

    • Datentyp: String

    • Als Dashboardfilter anheften: aktiviert

    • Quelle: Feste Werte

      Verwenden Sie in diesem Beispiel folgende Werte:

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

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

    • Standardwert: Gewitterwind

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

Der Parameter kann im Seitenbereich Parameter angezeigt werden, wird aber derzeit nicht in Visuals verwendet.

Verwenden eines Single-Selection-Parameters mit festen Werten

  1. Führen Sie eine Beispielabfrage mit dem neuen Event TypTope-Parameter aus, indem Sie den _eventType Variablennamen verwenden:

    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 obersten fünf Zustände.

Parameter für die Mehrfachauswahl mit festen Werten

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 unter Verwenden eines Single-Selection-Parameters mit festen Werten beschriebenen Details mit den folgenden Änderungen an:

    • 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 eines Mehrfachauswahlparameters mit festen Werten

  1. Führen Sie eine Beispielabfrage mit dem neuen Ereignistypparameter aus, indem Sie die _eventType Variable 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: Auswählen mehrerer Ereignistypen

Abfragebasierte Parameter für die Einzelauswahl

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 Einzelauswahlparameters

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

  2. Geben Sie die unter Verwenden eines Single-Selection-Parameters mit festen Werten beschriebenen Details mit den folgenden Änderungen an:

    • Bezeichnung: Status

    • Variablenname: _state

    • Quelle: Abfrage

    • Datenquelle: StormEventsSample

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

      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: State

    • Anzeigename: Status

    • Standardwert: Wählen Sie einen Standardwert aus.

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

Verwenden eines abfragebasierten Einzelauswahlparameters

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

    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 mehrfache Auswahl

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:

Erstellen eines abfragebasierten Mehrfachauswahlparameters

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

    1. Geben Sie die unter Verwenden eines Single-Selection-Parameters mit festen Werten beschriebenen Details mit den folgenden Änderungen an:
    • Bezeichnung: Status
    • Parametertyp: Mehrfachauswahl
    • Variablenname: _state

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

Verwenden eines abfragebasierten Mehrfachauswahlparameters

  1. In der folgenden Beispielabfrage wird der neue State-Parameter mithilfe der _state Variablen verwendet.

    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.

Freitextparameter

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. Geben Sie die Details wie folgt ein:

    • Bezeichnung: Status
    • Parametertyp: Freier Text
    • Variablenname: _state
    • Datentyp: String
    • Standardwert: Für dieses Feld gibt es keinen Standardwert.

Verwenden eines Freitextparameters

  1. Führen Sie eine Beispielabfrage mit dem neuen State-Parameter aus, indem Sie den _state Variablennamen 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

Datenquellenparameter

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

Erstellen eines Datenquellenparameters

  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 folgt ein:

    • Bezeichnung: Quelle
    • Parametertyp: Datenquelle
    • Auf Seiten anzeigen: Alle auswählen
    • Werte: Wählen Sie alle aus.
    • Standardwert: StormEventsSample

  3. Wählen Sie Fertigaus.

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

Verwenden eines Datenquellenparameters

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

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

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

  4. Verwenden Sie den Cluster-Parameter , 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 die Option im Visual aktivieren und dann den Parameter angeben, der zum Filtern der Daten verwendet wird.

  1. Navigieren Sie zur Abfrage der Kachel, 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 Visual auswählen können. Klicken Sie zum Auswählen eines Wertebereichs, z. B. in einem Zeitdiagramm, auf Ziehen.

  5. Geben Sie sowohl die Spalte an, die zum Bereitstellen des Werts verwendet wird, als auch einen Parameter an, 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 eines Tabellenvisuals mit der Option für das kontextmenüübergreifende Filter

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 eines Tabellenvisuals mit der Schaltfläche zum Zurücksetzen

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 Drillthroughseite 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
    Zielseite Eine oder mehrere Zielseiten, die mit den definierten Parametern drillen können.
    Column 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 Dashboard Visuals, das die Drillthroughinteraktion zeigt.

Um zur Quellseite zurückzukehren, wählen Sie oben rechts auf der Zielseite 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, sodass nur die Werte angezeigt werden, die dem Suchbegriff entsprechen.

Verwandte Inhalte