Co jsou parametry řídicího panelu?

Článek
07/27/2024

Parametry řídicího panelu AI/BI jsou jedním ze způsobů, jak vytvořit interaktivní řídicí panely, což uživatelům umožňuje používat selektory s jednou hodnotou a výběry dat za běhu. Pomocí parametrů můžete například filtrovat data na základě kritérií, jako jsou kalendářní data a kategorie produktů, než se data agregují v dotazu SQL, což umožňuje efektivnější dotazování a přesnou analýzu.

Parametry se přidají do datových sad a připojí se k jednomu nebo několika widgetům na plátně řídicího panelu autorem nebo editorem řídicího panelu. Uživatelé řídicího panelu pracují s daty řídicího panelu výběrem hodnot ve widgetech filtru za běhu. Tím se znovu spustí přidružené dotazy a zobrazí vizualizace založené na filtrovaných datech.

Parametry přímo upravují dotaz, což může být výkonné. Filtry datových sad 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 Filtry.

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:

Umístěte kurzor na místo, kam chcete do dotazu umístit parametr.
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:

Klikněte 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.
Kliknutím na jinou část uživatelského rozhraní dialogové okno zavřete.

Nastavení výchozí hodnoty parametru

Výchozí hodnotu parametru můžete nastavit tak, že ji 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.

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:

Vytvořte datovou sadu, jejíž sada výsledků je omezena na seznam možných hodnot parametrů.
Vytvořte dotaz datové sady, který používá parametr.
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.

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:

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

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

Příklady syntaxe parametrů

Následující příklady ukazují některé běžné případy použití parametrů.

Vložení data

Následující příklad obsahuje parametr Date , který omezuje výsledky dotazu na záznamy po určitém datu.


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

Vložení čísla

Následující příklad obsahuje číselný parametr, který omezuje výsledky na záznamy, kde o_total_price je pole větší než zadaná hodnota parametru.


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

Vložení názvu pole

V následujícím příkladu field_param IDENTIFIER se funkce používá k poskytnutí prahové hodnoty dotazu za běhu. Hodnota parametru by měla být název sloupce z tabulky použité v dotazu.


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

Vložení databázových objektů

Následující příklad vytvoří tři parametry: catalog, schemaa table. Uživatelé řídicího panelu můžou pomocí widgetů filtru na plátně vybrat hodnoty parametrů.


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

Viz klauzule IDENTIFIER.

Důležité

Povolení přístupu uživatelů řídicích panelů 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.

Zřetězení více parametrů

Parametry můžete zahrnout do jiných funkcí SQL. Tento příklad umožňuje prohlížeči vybrat jméno zaměstnance a ID čísla. Dotaz použije format_string funkci ke zřetězení dvou řetězců a filtrování podle odpovídajících řádků. Viz format_string funkce.


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

Parametry řídicího panelu versus parametry dotazu SQL Databricks

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 SQL databricks.

Změny syntaxe

Následující tabulka uvádí běžné případy použití parametrů, původní syntaxi SQL Databricks a ekvivalentní syntaxi pomocí syntaxe pojmenované značky parametrů.

Případ použití parametru	Syntaxe SQL Databricks	Syntaxe řídicího panelu AI/BI
Načtení pouze dat před zadaným datem	`WHERE date_field < '{{date_param}}'` Je nutné zahrnout uvozovky kolem parametru data a složených závorek.	`WHERE date_field < :date_param`
Načtení pouze dat menší než zadaná číselná hodnota	`WHERE price < {{max_price}}`	`WHERE price < :max_price`
Porovnání dvou řetězců	`WHERE region = {{region_param}}`	`WHERE region = :region_param`
Zadání tabulky použité v dotazu	`SELECT * FROM {{table_name}}`	`SELECT * FROM IDENTIFIER(:table)` Když uživatel zadá tento parametr, měl by k identifikaci tabulky použít úplný tříúrovňový obor názvů.
Nezávisle zadejte katalog, schéma a tabulku použitou v dotazu.	`SELECT * FROM {{catalog}}.{{schema}}.{{table}}`	''SELECT * FROM IDENTIFIER(:catalog
Použití parametrů jako šablony v delším formátovaném řetězci	"({{area_code}}) {{phone_number}}" Hodnoty parametrů se automaticky zřetězeny jako řetězec.	format_string("(%d)%d; :area_code; :p hone_number) Úplný příklad najdete v tématu Concatenate více parametrů .

Sdílet prostřednictvím