Verwenden von abfragebasierten Parametern

In diesem Artikel finden Sie die Schritte zum Erstellen eines interaktiven Dashboards, das abfragebasierte Parameter verwendet. Dabei wird eine grundlegende Vertrautheit mit dem Erstellen von Dashboards in Azure Databricks vorausgesetzt. Weitere grundlegende Anweisungen zum Erstellen von Dashboards finden Sie unter Erste Schritte.

Anforderungen

• Sie sind bei einem Azure Databricks-Arbeitsbereich angemeldet.
• Sie verfügen über die SQL-Berechtigung in diesem Arbeitsbereich.
• Sie verfügen mindestens über den KANN VERWENDEN-Zugriff der Ebene für ein oder mehrere SQL-Warehouses.

Erstellen eines Dashboard-Datasets

In diesem Tutorial werden generierte Daten aus dem Beispielkatalog für Azure Databricks verwendet.

1. Wählen Sie auf der Seitenleiste Neu und dann im Menü Dashboard aus.

2. Klicken Sie auf die Registerkarte Daten .

3. Wählen Sie Aus SQL erstellen aus, und fügen Sie die folgende Abfrage in den Editor ein. Wählen Sie erneut Ausführen aus, um die Ergebnisse zurückzugeben.

   SELECT
     *
   FROM
     samples.tpch.customer
   

4. Das neu definierte Dataset wird automatisch unter dem Namen Unbenanntes Dataset gespeichert. Doppelklicken Sie auf den Titel, und benennen Sie es in Marketingsegment um.

Hinzufügen eines Parameters

Sie können diesem Dataset einen Parameter hinzufügen, um die zurückgegebenen Werte zu filtern. Der Parameter in diesem Beispiel lautet :segment. Weitere Informationen zur Parametersyntax finden Sie unter Arbeiten mit Dashboardparametern.

1. Fügen Sie die folgende WHERE-Klausel am Ende der Abfrage ein. Unterhalb der Abfrage wird ein Textfeld mit dem Parameternamen segment angezeigt.

   WHERE
     c_mktsegment = :segment
   

2. Geben Sie in das Textfeld unterhalb der Abfrage BUILDING ein, um den Standardwert für den Parameter festzulegen.

3. Führen Sie die Abfrage erneut aus, um die Ergebnisse zu überprüfen.

Konfigurieren eines Visualisierungs-Widgets

Führen Sie die folgenden Schritte aus, um eine Visualisierung für Ihr Dataset auf der Canvas hinzuzufügen:

1. Klicken Sie auf die Registerkarte Canvas.
2. Wählen Sie Visualisierung erstellen aus, um ein Visualisierungs-Widget zu erstellen, und platzieren Sie es mit der Maus auf der Canvas.

Einrichten der X-Achse

1. Wenn nötig, wählen Sie im Dropdownmenü Visualisierung den Eintrag Balken aus.
2. Wählen Sie aus, um die Daten auszuwählen, die auf der X-Achse angezeigt werden. Sie können die Suchleiste verwenden, um nach einem Feld anhand des Namens zu suchen. Wählen Sie c_nationkey aus.
3. Klicken Sie auf den Feldnamen, den Sie ausgewählt haben, um weitere Konfigurationsoptionen anzuzeigen.
   • Wählen Sie als Skalentyp die Option Kategorisch aus.
   • Wählen Sie für die Auswahl Transformieren die Option Keine aus.

Einrichten der Y-Achse

1. Wählen Sie neben der Y-Achse und dann c_acctbal aus.
2. Klicken Sie auf den Feldnamen, den Sie ausgewählt haben, um weitere Konfigurationsoptionen anzuzeigen.
   • Wählen Sie als Skalierungstyp Quantitativ aus.
   • Wählen Sie für die Auswahl Transformieren die Option SUM aus.

Die Visualisierung wird während des Konfigurierens automatisch aktualisiert. Die angezeigten Daten enthalten nur Datensätze, in denen segment den Wert BUILDING hat.

Hinzufügen eines Filters

Richten Sie einen Filter ein, damit Personen, die das Dashboard anzeigen, den Fokus für das Marketingsegment steuern können.

1. Klicken Sie auf Filter hinzufügen (Feld/Parameter), um ein Filter-Widget hinzuzufügen. Platzieren Sie es auf dem Canvas.
2. Wählen Sie im Konfigurationsbereich im Dropdownmenü Filter die Option Einzelwert aus.
3. Aktivieren Sie das Kontrollkästchen Titel, um in Ihrem Filter-Widget ein Titelfeld zu erstellen.
4. Wählen Sie den Platzhaltertitel des Widgets aus, und geben Sie Segment ein, um den Filter umzubenennen.
5. Klicken Sie auf neben "Parameter" im Konfigurationsbereich.
6. Wählen Sie im Marketingsegment-Dataset Segment aus.

Das konfigurierte Filter-Widget zeigt den Standardparameterwert für das Dataset an.

Definieren einer Auswahl von Werten

Der von Ihnen erstellte Filter ist funktionsfähig, erfordert jedoch, dass die Personen den verfügbaren Auswahlbereich kennen müssen, um eine Auswahl eingeben zu können. Außerdem müssen diese Personen die Groß- und Kleinschreibung und die Schreibweise beim Eingeben des gewünschten Parameterwerts beachten.

Um eine Dropdownliste zu erstellen, über die ein Parameter aus einer Liste der verfügbaren Optionen ausgewählt werden kann, erstellen Sie ein neues Dataset, um die Liste der möglichen Werte zu definieren.

1. Klicken Sie auf die Registerkarte Daten .

2. Wählen Sie Aus SQL erstellen aus, um ein neues Dataset zu erstellen.

3. Kopieren Sie den folgenden Code, und fügen Sie ihn in den Editor ein:

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. Führen Sie Ihre Abfrage aus, und überprüfen Sie die Ergebnisse. Die fünf Marketingsegmente aus der Tabelle werden in den Ergebnissen angezeigt.

5. Doppelklicken Sie auf den automatisch generierten Titel, und benennen Sie diese Dataset in Segmentauswahl um.

Aktualisieren des Filters

Aktualisieren Sie Ihren vorhandenen Filter, um das soeben erstellte Dataset für das Ausfüllen einer Dropdownliste mit Werten zu verwenden, aus denen Benutzerinnen und Benutzer auswählen können.

1. Wählen Sie Canvas aus. Wählen Sie dann das Filter-Widget aus, das Sie in einem vorherigen Schritt erstellt haben.
2. Wählen Sie neben Felder aus.
3. Wählen Sie Segmentauswahl und dann den Feldnamen c_mktsegment aus.

Ihr Filter-Widget wird aktualisiert, während Sie die Konfiguration ändern. Wählen Sie das Feld im Filter-Widget aus, um die verfügbaren Optionen im Dropdownmenü anzuzeigen.

Hinweis

Dieses Tutorial enthält einen vereinfachten Anwendungsfall, der nur veranschaulichen soll, wie abfragebasierte Parameter verwendet werden. Ein alternativer Ansatz zum Erstellen dieses Dashboards besteht darin, einen Filter auf das Feld c_mktsegment anzuwenden.

Nächste Schritte

Informieren Sie sich in den folgenden Artikel weiter über die Verwendung von Dashboards:

• Weitere Informationen zum Anwenden von Filtern Siehe Verwenden von Filtern.
• Weitere Informationen zu Dashboardparametern Siehe Arbeiten mit Dashboardparametern.
• Veröffentlichen und Freigeben Ihres Dashboards Weitere Informationen finden Sie unter Veröffentlichen eines Dashboards.