Delen via

Werken met dashboardparameters

  • Artikel

In dit artikel wordt uitgelegd hoe u parameters gebruikt op AI/BI-dashboards. Als u in plaats daarvan meer wilt weten over veldfilters, raadpleegt u Filteren op velden.

Met AI/BI-dashboardparameters kunt u tijdens runtime verschillende waarden in gegevenssetquery's vervangen. Hiermee kunt u gegevens filteren op criteria zoals datums en productcategorieën voordat gegevens worden samengevoegd in een SQL-query, wat leidt tot efficiëntere query's en nauwkeurige analyse. Parameters kunnen worden gebruikt met filterwidgets om dashboards interactief of met visualisatiewidgets te maken om gegevenssets gemakkelijker te hergebruiken.

Auteurs of editors van dashboards voegen parameters toe aan gegevenssets en verbinden ze met een of meer widgets op het dashboardcanvas. Voor statische parameters die zijn ingesteld in visualisatiewidgets, worden de waarden ingesteld door de auteurs of editors. Voor parameters die worden gebruikt in filterwidgets, kunnen dashboardviewers communiceren met de gegevens door tijdens runtime waarden te selecteren in filterwidgets. Met deze interactie worden de bijbehorende query's opnieuw uitgevoerd en worden visualisaties weergegeven op basis van de gefilterde gegevens.

Parameters wijzigen de query rechtstreeks, wat krachtig kan zijn. Veldfilters voor gegevenssets kunnen ook interactiviteit van dashboards, meer functies en betere prestaties bieden met grote gegevenssets dan parameters. Zie Filters gebruiken.

Een parameter toevoegen aan een query

U moet ten minste MACHTIGINGEN VOOR BEWERKEN hebben op het conceptdashboard om een parameter toe te voegen aan een dashboardgegevensset. U kunt parameters rechtstreeks toevoegen aan de gegevenssetquery's op het tabblad Gegevens .

Gif toont een voorbeeld van de volgende stappen.

Een parameter toevoegen aan een query:

  1. Plaats de cursor op de positie waar u de parameter in uw query wilt plaatsen.

  2. Klik op Parameter toevoegen om een nieuwe parameter in te voegen.

    Hiermee maakt u een nieuwe parameter met de standaardnaam parameter. Als u de standaardnaam wilt wijzigen, vervangt u deze in de queryeditor. U kunt ook parameters toevoegen door deze syntaxis te typen in de query-editor.

Een queryparameter bewerken

Een parameter bewerken:

  1. Klik naast Tandwielpictogram de parameternaam. Er wordt een dialoogvenster parameterdetails weergegeven en bevat de volgende configuratieopties:
    • Trefwoord: het trefwoord dat de parameter in de query vertegenwoordigt. Dit kan alleen worden gewijzigd door de tekst in de query rechtstreeks bij te werken.
    • Weergavenaam: De naam in de filtereditor. De titel is standaard hetzelfde als het trefwoord.
    • Type: Ondersteunde typen zijn tekenreeks, datum, datum en tijd, numeriek.
      • Het standaardtype is Tekenreeks.
      • Met het numerieke gegevenstype kunt u opgeven tussen Decimaal en Geheel getal. Het standaard numerieke type is Decimaal.
  2. Klik op een ander deel van de gebruikersinterface om het dialoogvenster te sluiten.

Een standaardparameterwaarde instellen

Als u de query wilt uitvoeren, kiest u een standaardwaarde voor de parameter door deze in het tekstveld onder de parameternaam te typen. Voer de query uit om een voorbeeld van de queryresultaten te bekijken met de parameterwaarde die is toegepast. Als u de query uitvoert, wordt ook de standaardwaarde opgeslagen. Wanneer u deze parameter instelt met behulp van een filterwidget op het canvas, wordt de standaardwaarde gebruikt, tenzij er een nieuwe standaardwaarde is opgegeven in de filterwidget. Zie Filters gebruiken.

Parameters op basis van query's

Met op query's gebaseerde parameters kunnen auteurs een dynamische of statische lijst met waarden definiëren waaruit kijkers kunnen kiezen bij het instellen van parameters tijdens het verkennen van gegevens in een dashboard. Ze worden gedefinieerd door een veldfilter en een parameterfilter te combineren in één filterwidget.

Als u een op query's gebaseerde parameter wilt maken, voert de auteur van het dashboard de volgende stappen uit:

  1. Maak een gegevensset waarvan de resultatenset is beperkt tot een lijst met mogelijke parameterwaarden.
  2. Maak een gegevenssetquery die gebruikmaakt van een parameter.
  3. Configureer een filterwidget op het canvas dat filtert op een veld en gebruikt een parameter.
    • De veldenconfiguraties moeten worden ingesteld om het veld te gebruiken met de gewenste lijst met in aanmerking komende parameterwaarden.
    • De parameterconfiguratie moet worden ingesteld om een parameterwaarde te selecteren.

Notitie

Als een gegevensset die wordt gebruikt in queryparameters ook wordt gebruikt in andere visualisaties op een dashboard, worden met de filterselectie van een viewer alle verbonden query's gewijzigd. Om dit te voorkomen, moeten auteurs een toegewezen gegevensset maken voor op query's gebaseerde parameters die niet worden gebruikt in andere visualisaties op het dashboard.

Zie Op query's gebaseerde parameters gebruiken voor een stapsgewijze zelfstudie die laat zien hoe u een op query's gebaseerde parameter en visualisatie toevoegt.

Een lijst met dynamische parameters maken

Als u een dynamische gegevensset wilt maken die de vervolgkeuzelijst vult die kijkers gebruiken om parameterwaarden te selecteren, schrijft u een SQL-query die één veld retourneert en alle waarden in dat veld bevat. Elke nieuwe waarde in dat veld wordt automatisch toegevoegd als parameterselectie wanneer de gegevensset wordt bijgewerkt. Een voorbeeld van een SQL-query is als volgt:

 SELECT
    DISTINCT c_mktsegment
  FROM
    samples.tpch.customer

Een statische parameterlijst maken

U kunt een statische gegevensset maken die alleen waarden bevat die u in uw gegevensset hebt vastgelegd. Een voorbeeldquery is als volgt:

SELECT
  *
FROM
  (
    VALUES
      ('MACHINERY'),
      ('BUILDING'),
      ('FURNITURE'),
      ('HOUSEHOLD'),
      ('AUTOMOBILE')
  ) AS data(available_choices)

Filtertypen

Filters voor enkele waarde en datumkiezer ondersteunen instellingsparameters. Wanneer u op query's gebaseerde parameters instelt met een datumkiezerfilter , worden datums die worden weergegeven in de resultaten van de onderliggende query zwart weergegeven. Datums die niet in de queryresultaten worden weergegeven, zijn grijs. Gebruikers kunnen grijze datums kiezen, ook al zijn ze niet opgenomen in de onderliggende query.

Een queryparameter verwijderen

Als u een parameter wilt verwijderen, verwijdert u deze uit uw query.

Parameters voor statische widget

Statische widgetparameters worden rechtstreeks in een visualisatiewidget geconfigureerd, zodat auteurs visualisatiewidgets die dezelfde gegevensset delen afzonderlijk kunnen parameteriseren. Hierdoor kan dezelfde gegevensset verschillende weergaven op het canvas presenteren.

Het voorbeeld in deze sectie is gebaseerd op een gegevensset waarmee een query op de samples.nyctaxi.trips tabel wordt uitgevoerd. De opgegeven query retourneert de afstand van elke reis en categoriseert de ophaaldag als of Weekday Weekend. De queryparameter filtert op resultaten op basis van of het ophalen op een weekdag of weekend heeft plaatsgevonden.

De querytekst wordt weergegeven in het volgende codeblok, maar de instructies in deze sectie zijn beperkt tot het instellen van de bijbehorende visualisaties die zijn geconfigureerd met statische widgetparameters. Zie Een parameter toevoegen aan een query voor instructies over het instellen van een gegevensset met parameters.


  WITH DayType AS (
    SELECT
      CASE
        WHEN DAYOFWEEK(tpep_pickup_datetime) IN (1, 7) THEN 'Weekend'
        ELSE 'Weekday'
      END AS day_type,
      trip_distance
    FROM samples.nyctaxi.trips
  )
  SELECT day_type, trip_distance
  FROM DayType
  WHERE day_type = :day_type_param

Een statische widgetparameter toevoegen aan een visualisatie:

  1. Voeg een visualisatiewidget toe aan het canvas van het conceptdashboard.

  2. Als de nieuwe widget is geselecteerd, kiest u de geparameteriseerde gegevensset in de vervolgkeuzelijst Gegevensset in het configuratievenster.

  3. Klik op Filters weergeven. Voor gegevenssets met parameters wordt een sectie Parameters weergegeven in het configuratievenster.

    Een visualisatieconfiguratiepaneel met de optie om een paramter te kiezen.

  4. Klik op het plusteken rechts van de kop Parameters en kies een parameter in de vervolgkeuzelijst.

  5. Standaard weerspiegelt de parameterwaarde wat is ingesteld in de query op het tabblad Gegevens . U kunt deze behouden of een nieuwe waarde kiezen om in de gegevensset te vervangen. Navigeer weg van het tekstveld om de visualisatie weer te geven met de nieuwe parameter die is toegepast.

  6. Controleer uw dashboard.

    In de volgende afbeelding ziet u twee visualisatiewidgets, die elk zijn geconfigureerd als een histogram met een parameter voor een statische widget. In het diagram aan de linkerkant ziet u de verdeling van reisafstanden voor reizen vanaf weekdagen, terwijl in het diagram aan de rechterkant dezelfde gegevens worden weergegeven voor weekenden. Beide visualisaties zijn gebaseerd op dezelfde gegevensset.

    Twee histogrammen, geconfigureerd voor het gebruik van parameters op het niveau van statische widget, zoals beschreven.

Gegevens vergelijken met behulp van een filtervoorwaarde

U kunt een filtervoorwaarde toevoegen waarmee u aggregaties op een deel van de gegevens kunt vergelijken met de aggregaties die zijn toegepast op de hele gegevensset.

In het volgende voorbeeld wordt de vorige query uitgebreid met een filtervoorwaarde waarbij de opgegeven parameterwaarde is All, die niet in de gegevens wordt weergegeven. Het eerste deel van de filtervoorwaarde werkt hetzelfde als in het vorige voorbeeld, filteren op resultaten waarbij de day_type voorwaarde is Weekday of Weekend. Het tweede deel van de filtervoorwaarde controleert of de parameter zelf is ingesteld op een bepaalde waarde, in dit geval All, die niet in de gegevens wordt weergegeven. Wanneer u de standaardwaarde voor die parameter instelt in de gegevensseteditor, slaat u het filter effectief over wanneer noch Weekday Weekend als waarden worden doorgegeven.


WITH DayType AS (
  SELECT
    CASE
      WHEN DAYOFWEEK(tpep_pickup_datetime) IN (1, 7) THEN 'Weekend'
      ELSE 'Weekday'
    END AS day_type,
    trip_distance
  FROM
    samples.nyctaxi.trips
)
SELECT
  day_type,
  trip_distance
FROM
  DayType
WHERE
  day_type = :day_type_param
  OR :day_type_param = 'All'

U kunt deze gegevensset gebruiken om drie visualisatiewidgets te configureren, met de day_type_param set op AllrespectievelijkWeekend. Weekday Vervolgens kunnen dashboardviewers elk van de gegevenssets die zijn gefilterd op dagtype vergelijken met de hele gegevensset.

In de volgende GIF ziet u hoe u snel drie grafieken kunt maken op basis van de gegevensset die met deze query is gemaakt.

  1. De eerste grafiek is geconfigureerd om de gegevensset Trip Distances by Day Type weer te geven met een parameterwaarde die is ingesteld op Weekdag.
  2. Kloon de grafiek om alle toegepaste configuraties te onderhouden.
  3. Als u gegevens wilt weergeven voor ritten die in het weekend zijn gemaakt, past u de statische parameter aan op Weekend.
  4. Kloon de nieuwe grafiek om alle eerder toegepaste configuraties te onderhouden.
  5. Stel de parameter in de nieuwe grafiek in op All om het totale aantal ritten per afstand voor weekend- en weekdagreizen weer te geven.

Een GIF zoals beschreven in de voorgaande tekst.

Parameters weergeven op het dashboard

Door een filter toe te voegen aan uw dashboardcanvas, kunnen kijkers parameterwaarden selecteren en wijzigen, zodat ze de gegevens interactief kunnen verkennen en analyseren. Als u de parameter niet beschikbaar maakt op het dashboard, zien kijkers alleen queryresultaten die gebruikmaken van de standaardparameterwaarde die u in de query hebt ingesteld.

Ga als volgende te werk om een parameter toe te voegen aan uw dashboard:

  1. Klik op Filterpictogram Een filter (veld/parameter) toevoegen.
  2. Klik pictogram veld toevoegen naast Parameters in het configuratievenster.
  3. Klik op de parameternaam die u wilt gebruiken voor de viewer met deze widget.

Werken met filterwidgets en statische parameters

Parameters zijn vaste waarden die tijdens runtime worden vervangen door een query. Als twee of meer verwijzingen naar dezelfde parameter zijn ingesteld met verschillende waarden wanneer uw dashboard wordt bijgewerkt, geven visualisatiewidgets een fout weer die aangeeft welke parameter conflicterende waarden heeft. Dit kan gebeuren wanneer meerdere filterwidgets dezelfde parameter gebruiken of wanneer een statische parameter conflicteert met een filterwidget waarmee viewerselectie kan worden toegestaan.

Als u terugvalwaarden voor verschillende parameters in dezelfde query wilt instellen, kunt u een patroon gebruiken zoals in het volgende voorbeeld.


CASE WHEN :static_param != 'All' THEN :static_param ELSE :dash_param END

In dit voorbeeld :static_param verwijst u naar een statische parameter, die moet worden ingesteld op 'Alles' in zowel de visualisatiewidget als de gegevensseteditor. De parameter :dash_param is een dynamische waarde die wordt bepaald door een filterwidget op het dashboardcanvas. Met deze instructie wordt gecontroleerd op een waarde die is opgegeven als een statische parameter. Als er geen is ingesteld, valt deze terug op een door de viewer geselecteerde dashboardparameterwaarde.

Parameters opnemen in de URL

Parameterinstellingen worden opgeslagen in de URL, zodat gebruikers een bladwijzer kunnen maken om de status van hun dashboard te behouden, inclusief vooraf ingestelde filters en parameters, of om deze te delen met anderen voor consistente toepassing van dezelfde filters en parameters.

Dashboardparameters versus Mustache-queryparameters

Dashboardparameters gebruiken dezelfde syntaxis als benoemde parametermarkeringen. Zie benoemde parametermarkeringen. Dashboards bieden geen ondersteuning voor mustache-stijlparameters.

Voorbeelden van syntaxis

Veelgebruikte toepassingen voor parameters zijn het invoegen van datums, getallen, tekst, databaseobjecten en waarden uit JSON-tekenreeksen. Zie Voorbeelden van benoemde parametersyntaxis voor voorbeelden die laten zien hoe u in deze gevallen parameters gebruikt

Belangrijk

Als kijkers toegang hebben tot gegevens via parameterselecties zoals tabel- of catalogusnamen, kan dit leiden tot onbedoelde blootstelling van gevoelige informatie. Als u een dashboard met deze opties publiceert, raadt Azure Databricks aan om referenties niet in te sluiten in het gepubliceerde dashboard.