Wat zijn dashboardparameters?

Dashboardparameters zijn een manier om dashboards interactief te maken, zodat kijkers tijdens runtime specifieke waarden kunnen invoeren in gegevenssetquery's. Parameters kunnen bijvoorbeeld gegevens filteren op basis van criteria zoals datums en productcategorieën voordat deze worden samengevoegd in een SQL-query, zodat query's en nauwkeurige analyses efficiënter kunnen worden uitgevoerd.

Parameters worden toegevoegd aan gegevenssets en verbonden met een of meer widgets op het canvas van een dashboard door een auteur of editor van een dashboard. Dashboardviewers communiceren met de dashboardgegevens door tijdens runtime waarden in filterwidgets te selecteren. Hiermee worden de bijbehorende query's opnieuw uitgevoerd en worden visualisaties weergegeven die zijn gebaseerd op de gefilterde gegevens.

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

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 .

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

U kunt een standaardwaarde voor uw parameter instellen 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.

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 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 Een filter (veld/parameter) toevoegen.
2. Klik naast Parameters in het configuratievenster.
3. Klik op de parameternaam die u wilt gebruiken voor de viewer met deze widget.

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.

Voorbeelden van parametersyntaxis

In de volgende voorbeelden ziet u enkele veelvoorkomende use cases voor parameters.

Een datum invoegen

Het volgende voorbeeld bevat een datumparameter waarmee queryresultaten worden beperkt tot records na een specifieke datum.

SELECT
  o_orderdate AS Date,
  o_orderpriority AS Priority,
  sum(o_totalprice) AS `Total Price`
FROM
  samples.tpch.orders
WHERE
  o_orderdate > :date_param
GROUP BY
  1,
  2

Een getal invoegen

Het volgende voorbeeld bevat een numerieke parameter waarmee de resultaten worden beperkt tot records waarin het o_total_price veld groter is dan de opgegeven parameterwaarde.

SELECT
  o_orderdate AS Date,
  o_orderpriority AS Priority,
  o_totalprice AS Price
FROM
  samples.tpch.orders
WHERE
  o_totalprice > :num_param

Een veldnaam invoegen

In het volgende voorbeeld wordt de field_paramIDENTIFIER functie gebruikt voor het opgeven van een drempelwaarde voor de query tijdens runtime. De parameterwaarde moet een kolomnaam zijn uit de tabel die in de query wordt gebruikt.

SELECT
  *
FROM
  samples.tpch.orders
WHERE
  IDENTIFIER(:field_param) < 10000

Databaseobjecten invoegen

In het volgende voorbeeld worden drie parameters gemaakt: catalog, schemaen table. Dashboardviewers kunnen filterwidgets op het canvas gebruiken om parameterwaarden te selecteren.

SELECT
  *
FROM
  IDENTIFIER(:catalog || '.' || :schema || '.' || :table)

Zie de ID-component.

Belangrijk

Als u dashboardviewers toegang biedt 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.

Meerdere parameters samenvoegen

U kunt parameters opnemen in andere SQL-functies. In dit voorbeeld kan de kijker een werknemertitel en een nummer-id selecteren. De query gebruikt de format_string functie om de twee tekenreeksen samen te voegen en te filteren op de rijen die overeenkomen. Zie format_string functie.

SELECT
  o_orderkey,
  o_clerk
FROM
  samples.tpch.orders
WHERE
  o_clerk LIKE format_string('%s%s', :title, :emp_number)

Dashboardparameters versus Databricks SQL-queryparameters

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