Sdílet prostřednictvím

Práce s parametry řídicího panelu

  • Článek

Tento článek vysvětluje, jak používat parametry na řídicích panelech AI/BI. Pokud chcete získat informace o filtrech polí, přečtěte si článek Filtr polí.

Parametry řídicího panelu AI/BI umožňují nahradit různé hodnoty dotazů na datové sady za běhu. To umožňuje filtrovat data podle kritérií, jako jsou kalendářní data a kategorie produktů před agregací dat v dotazu SQL, což vede k efektivnějšímu dotazování a přesné analýze. Parametry se dají použít s widgety filtru, aby řídicí panely byly interaktivní nebo s widgety vizualizací, aby se datové sady snadněji používaly.

Autoři nebo editory řídicích panelů přidávají do datových sad parametry a připojují je k jednomu nebo více widgetům na plátně řídicího panelu. U statických parametrů nastavených ve widgetech vizualizace jsou hodnoty nastavené autory nebo editory. U parametrů používaných ve widgetech filtru můžou uživatelé řídicích panelů pracovat s daty výběrem hodnot ve widgetech filtru za běhu. Tato interakce znovu spustí přidružené dotazy a zobrazí vizualizace na základě filtrovaných dat.

Parametry přímo upravují dotaz, což může být výkonné. Filtry polí datové sady můžou také nabízet interaktivitu řídicího panelu, více funkcí a lepší výkon s velkými datovými sadami než parametry. Viz Použití filtrů.

Přidání parametru do dotazu

Abyste mohli přidat parametr do datové sady řídicího panelu řídicího panelu, musíte mít na řídicím panelu alespoň oprávnění CAN EDIT. Parametry můžete přidat přímo do dotazů datové sady na kartě Data .

Gif ukazuje příklad následujících kroků.

Přidání parametru do dotazu:

  1. Umístěte kurzor na místo, kam chcete do dotazu umístit parametr.

  2. Kliknutím na Přidat parametr vložíte nový parametr.

    Tím se vytvoří nový parametr s výchozím názvem parameter. Pokud chcete změnit výchozí název, nahraďte ho v editoru dotazů. Parametry můžete také přidat zadáním této syntaxe v editoru dotazů.

Úprava parametru dotazu

Úprava parametru:

  1. Klikněte Ikona ozubeného kolečka vedle názvu parametru. Zobrazí se dialogové okno s podrobnostmi o parametrech a obsahuje následující možnosti konfigurace:
    • Klíčové slovo: Klíčové slovo, které představuje parametr v dotazu. To lze změnit pouze přímo aktualizací textu v dotazu.
    • Zobrazovaný název: Název v editoru filtrů. Ve výchozím nastavení je název stejný jako klíčové slovo.
    • Typ: Mezi podporované typy patří Řetězec, Datum, Datum a Čas, Číselné.
      • Výchozí typ je String.
      • Číselný datový typ umožňuje zadat mezi desetinným a celočíselným číslem. Výchozí číselný typ je Desetinné číslo.
  2. Kliknutím na jinou část uživatelského rozhraní dialogové okno zavřete.

Nastavení výchozí hodnoty parametru

Aby se dotaz spustil, zvolte výchozí hodnotu parametru tak, že ho zadáte do textového pole pod názvem parametru. Spuštěním dotazu zobrazte náhled výsledků dotazu s použitou hodnotou parametru. Spuštění dotazu také uloží výchozí hodnotu. Když tento parametr nastavíte pomocí widgetu filtru na plátně, použije se výchozí hodnota, pokud není ve widgetu filtru zadána nová výchozí hodnota. Viz Použití filtrů.

Parametry založené na dotazech

Parametry založené na dotazech umožňují autorům definovat dynamický nebo statický seznam hodnot, ze kterého můžou uživatelé vybírat při nastavování parametrů při zkoumání dat na řídicím panelu. Definují se kombinací filtru polí a filtru parametrů v jednom widgetu filtru.

Pokud chcete vytvořit parametr založený na dotazu, autor řídicího panelu provede následující kroky:

  1. Vytvořte datovou sadu, jejíž sada výsledků je omezena na seznam možných hodnot parametrů.
  2. Vytvořte dotaz datové sady, který používá parametr.
  3. Nakonfigurujte widget filtru na plátně, které filtruje pole a používá parametr.
    • Konfigurace polí by měly být nastaveny tak, aby používaly pole s požadovaným seznamem způsobilých hodnot parametrů.
    • Konfigurace parametrů by měla být nastavena tak, aby vybrala hodnotu parametru.

Poznámka:

Pokud se datová sada použitá v parametrech založených na dotazu používá také v jiných vizualizacích na řídicím panelu, výběr filtru prohlížeče upraví všechny připojené dotazy. Aby se tomu zabránilo, autoři by měli vytvořit vyhrazenou datovou sadu pro parametry založené na dotazech, které se nepoužívají v žádné jiné vizualizaci na řídicím panelu.

Podrobné kurzy ukazující přidání parametru a vizualizace založeného na dotazu najdete v tématu Použití parametrů založených na dotazech.

Vytvoření seznamu dynamických parametrů

Pokud chcete vytvořit dynamickou datovou sadu, která naplní rozevírací seznam, který čtenáři používají k výběru hodnot parametrů, napište dotaz SQL, který vrátí jedno pole a zahrne všechny hodnoty v daném poli. Jakákoli nová hodnota v daném poli se při aktualizaci datové sady automaticky přidá jako výběr parametru. Příklad dotazu SQL je následující:

 SELECT
    DISTINCT c_mktsegment
  FROM
    samples.tpch.customer

Vytvoření seznamu statických parametrů

Můžete vytvořit statickou datovou sadu, která obsahuje pouze hodnoty, které pevně zakódujete do datové sady. Příklad dotazu je následující:

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

Typy filtrů

Filtry výběrů s jednou hodnotou a datem podporují parametry nastavení. Při nastavování parametrů založených na dotazu pomocí filtru Výběr data se data, která se zobrazí ve výsledcích podkladového dotazu, se zobrazují černou. Data, která se ve výsledcích dotazu nezobrazují, jsou šedá. Uživatelé můžou zvolit šedá kalendářní data, i když nejsou zahrnuti do podkladového dotazu.

Odebrání parametru dotazu

Pokud chcete parametr odebrat, odstraňte ho z dotazu.

Statické parametry widgetu

Statické parametry widgetu se konfigurují přímo ve widgetu vizualizace, což autorům umožňuje individuálně parametrizovat widgety vizualizace, které sdílejí stejnou datovou sadu. To umožňuje stejné datové sadě prezentovat různá zobrazení na plátně.

Příklad v této části je založený na datové sadě, která se dotazuje na samples.nyctaxi.trips tabulku. Zadaný dotaz vrátí vzdálenost každé cesty a kategorizuje den vyzvednutí jako buď Weekday nebo Weekend. Parametr dotazu filtruje výsledky na základě toho, jestli k vyzvednutí došlo v pracovní den nebo o víkendu.

Text dotazu je k dispozici v následujícím bloku kódu, ale pokyny v této části jsou omezené na nastavení přidružených vizualizací nakonfigurovaných pomocí parametrů statického widgetu. Pokyny k nastavení datové sady s parametry najdete v tématu Přidání parametru do dotazu.


  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

Přidání parametru statického widgetu do vizualizace:

  1. Přidejte widget vizualizace na plátno řídicího panelu konceptu.

  2. Když je vybraný nový widget, zvolte v rozevíracím seznamu Datová sada na konfiguračním panelu parametrizovanou datovou sadu.

  3. Klikněte na Zobrazit filtry. U datových sad, které obsahují parametry, se na konfiguračním panelu zobrazí oddíl Parametry .

    Konfigurační panel vizualizace zobrazující možnost výběru parametru

  4. Klikněte na znaménko plus napravo od záhlaví Parametry a v rozevíracím seznamu zvolte parametr.

  5. Ve výchozím nastavení hodnota parametru zrcadlí, co je nastaveno v dotazu na kartě Data . Můžete ji ponechat nebo zvolit novou hodnotu, kterou chcete nahradit do datové sady. Pokud chcete zobrazit vizualizaci s použitím nového parametru, přejděte mimo textové pole.

  6. Zkontrolujte řídicí panel.

    Následující obrázek znázorňuje dva widgety vizualizace, z nichž každý je nakonfigurovaný jako histogram se statickým parametrem widgetu. Graf na levé straně zobrazuje distribuci vzdáleností jízdy pro cesty začínající v pracovní dny, zatímco graf vpravo zobrazuje stejná data pro víkendy. Obě vizualizace jsou založené na stejné datové sadě.

    Dva histogramy nakonfigurované tak, aby používaly statické parametry na úrovni widgetu, jak je popsáno.

Porovnání dat pomocí podmínky filtru

Můžete přidat podmínku filtru, která umožňuje porovnat agregace v části dat s agregacemi použitými pro celou datovou sadu.

Následující příklad rozšiřuje předchozí dotaz tak, aby zahrnoval podmínku filtru, kde zadaná hodnota parametru je All, která se nezobrazuje v datech. První část podmínky filtru funguje stejně jako v předchozím příkladu a filtruje výsledky, ve day_type kterých je buď Weekday nebo Weekend. Druhá část podmínky filtru zkontroluje, jestli je samotný parametr nastaven na určitou hodnotu, v tomto případě All, který se nezobrazuje v datech. Když nastavíte výchozí hodnotu pro tento parametr v editoru datových sad, filtr se v podstatě vynechá, když se ani Weekday Weekend nepředá jako hodnoty.


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'

Tuto datovou sadu můžete použít ke konfiguraci tří widgetů vizualizace s nastaveným day_type_param nastavením a Weekday AllWeekend v uvedeném pořadí. Uživatelé řídicího panelu pak můžou porovnat každou datovou sadu filtrovanou podle typu dne s celou datovou sadou.

Následující gif ukazuje, jak můžete rychle vytvořit tři grafy z datové sady vytvořené pomocí tohoto dotazu.

  1. První graf je nakonfigurovaný tak, aby zobrazoval datovou sadu Vzdálenosti jízdy podle typu dne s hodnotou parametru nastavenou na Den v týdnu.
  2. Naklonujte graf, aby se zachovaly všechny použité konfigurace.
  3. Pokud chcete zobrazit data pro výlety o víkendu, upravte statický parametr na Víkend.
  4. Naklonujte nový graf, aby se zachovaly všechny dříve použité konfigurace.
  5. Nastavte parametr v novém grafu na Vše a zobrazte celkový počet jízd na dálku pro víkendové a týdenní výlety.

Obrázek GIF, jak je popsáno v předchozím textu.

Zobrazení parametrů na řídicím panelu

Přidání filtru na plátno řídicího panelu umožňuje uživatelům vybírat a upravovat hodnoty parametrů, aby mohli data interaktivně zkoumat a analyzovat. Pokud parametr na řídicím panelu nezpřístupníte, zobrazí se uživatelům pouze výsledky dotazu, které používají výchozí hodnotu parametru, kterou jste nastavili v dotazu.

Přidání parametru na řídicí panel:

  1. Klikněte na Ikona filtru Přidat filtr (pole nebo parametr).
  2. V konfiguračním panelu klikněte na Ikona přidat pole tlačítko Parametry .
  3. Klikněte na název parametru, který má prohlížeč používat s tímto widgetem.

Práce s widgety filtru a statickými parametry

Parametry jsou pevné hodnoty nahrazené dotazem za běhu. Pokud se při aktualizaci řídicího panelu nastaví dva nebo více odkazů na stejný parametr s různými hodnotami, zobrazí widgety vizualizace chybu označující, který parametr má konfliktní hodnoty. K tomu může dojít, když více widgetů filtru používá stejný parametr nebo když statický parametr koliduje s widgetem filtru, který umožňuje výběr prohlížeče.

Pokud chcete nastavit záložní hodnoty pro různé parametry ve stejném dotazu, můžete použít vzor podobný jako v následujícím příkladu.


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

V tomto příkladu :static_param se odkazuje na statický parametr, který by měl být v widgetu vizualizace i v editoru datových sad nastavený na Vše. :dash_param Parametr je dynamická hodnota řízená widgetem filtru na plátně řídicího panelu. Tento příkaz vyhledá hodnotu zadanou jako statický parametr. Pokud není nastavená žádná hodnota, vrátí se zpět do hodnoty parametru řídicího panelu vybraného prohlížečem.

Zahrnutí parametrů do adresy URL

Nastavení parametrů jsou uložená v adrese URL, což uživatelům umožňuje označit záložku, aby zachovali stav řídicího panelu, včetně předem nastavených filtrů a parametrů, nebo je mohli sdílet s ostatními pro konzistentní použití stejných filtrů a parametrů.

Parametry řídicího panelu versus parametry dotazu Mustache

Parametry řídicího panelu používají stejnou syntaxi jako značky pojmenovaných parametrů. Viz značky pojmenovaných parametrů. Řídicí panely nepodporují parametry stylu Mustache.

Příklady syntaxe

Mezi běžné použití parametrů patří vkládání kalendářních dat, čísel, textu, databázových objektů a hodnot z řetězců JSON. Příklady, které demonstrují použití parametrů v těchto případech, najdete v příkladech syntaxe pojmenovaných parametrů.

Důležité

Povolení přístupu uživatelů k datům prostřednictvím výběrů parametrů, jako jsou názvy tabulek nebo katalogů, může vést k náhodnému vystavení citlivých informací. Pokud publikujete řídicí panel s těmito možnostmi, Azure Databricks doporučuje nevkládat přihlašovací údaje do publikovaného řídicího panelu.