Použití parametrů řídicího panelu

Parametry řídicího panelu jsou jedním ze způsobů, jak vytvořit interaktivní řídicí panely a umožnit uživatelům používat selektory s jednou hodnotou a výběry kalendářních dat k zadávání konkrétních hodnot do dotazů na datové sady za běhu. Parametry můžou například filtrovat data na základě kritérií, jako jsou kalendářní data a kategorie produktů, než se agregují v dotazu SQL, což umožňuje efektivnější dotazování a přesnější 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

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

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

Úprava parametru:

1. Klikněte vedle názvu parametru. Zobrazí se dialogové okno s podrobnostmi parametru .

   Dialogové okno 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.

Odebrání parametru

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

Použití parametru na plátně řídicího panelu

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

1. Klikněte na Přidat filtr (pole nebo parametr).
2. V konfiguračním panelu klikněte na tlačítko Parametry .
3. 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ů

(1) Hodnoty se vloží pomocí format_string funkce. Viz format_string funkce.

Následující příklady obsahují případ použití následovaný ukázkovou syntaxí.

• Zahrnout pouze záznamy před konkrétním datem.

  WHERE date_field < :date_param

• Zahrňte pouze ceny pod určitou cenu.

  WHERE price < :max_price

• Vyberte tabulku, která se má použít v dotazu.

  SELECT * FROM IDENTIFIER(:param)

• Změňte katalog, schéma a tabulku použitou v dotazu.

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

• Zkombinujte dva parametry se závorkami a vytvořte formátovaná telefonní čísla.

  Následující příklad používá format_string funkci k vložení hodnot. Viz format_string funkce.

  format_string('(%d) %d', :area_code, :phone_number)

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.

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.