Práce s widgety parametrů

Když do dotazu přidáte pojmenovanou značku parametru , Azure Databricks zobrazí widget parametrů v uživatelském rozhraní. Widgety umožňují uživatelům nastavit hodnoty parametrů bez přímé úpravy dotazu. Můžete nakonfigurovat typ, název a výchozí hodnotu každého widgetu.

Widgety parametrů jsou podporované v editoru SQL, poznámkových blocích, řídicích panelech AI/BI a v Genie Spaces, ale v těchto plochách se chovají odlišně. Tato stránka popisuje widgety parametrů v editoru SQL. Další povrchy najdete tady:

V editoru SQL může jakýkoli typ parametru (String, Integer, Decimal, Date, Timestamp) použít libovolný typ widgetu.

Konfigurace widgetu parametrů

  1. Přidejte do dotazu pojmenovanou značku parametru. V uživatelském rozhraní se zobrazí widget.
  2. Kliknutím na ikonu ozubeného kola vedle widgetu otevřete dialogové okno widgetu. Dialogové okno pro vytvoření widgetu
  3. Nastavte následující pole:
    • Název parametru: Název parametru, který se zobrazí v dotazu. Pokud změníte název parametru, musíte ho v dialogovém okně widgetu také změnit v dotazu.
    • Popisek widgetu: Řetězec popisovaný widgetem
    • Typ widgetu: Určuje, jak uživatelé zadávají hodnotu. Viz typy widgetů níže.
    • Typ parametru: Datový typ parametru. Viz typy parametrů.
  4. Kliknutím mimo dialogové okno widgetu uložte provedené změny.

Úpravy, odebrání a změna pořadí widgetů

Upravit: Kliknutím na ikonu ozubeného kolečka vedle widgetu znovu otevřete podokno nastavení.

Odstraňte: Odstraňte z dotazu značku parametru. Widget se odebere automaticky.

Změna pořadí: Pomocí úchytu přetažení vlevo od widgetu můžete změnit pořadí.

Typy widgetů

Azure Databricks podporuje následující typy widgetů pro parametry dotazu:

Typ widgetu Description
Rozevírací seznam Uživatelé si musí vybrat z předdefinovaného seznamu.
Combobox Uživatelé si můžou vybrat z předdefinovaného seznamu nebo zadat vlastní hodnotu.
Textové zadání Přijme libovolnou hodnotu volného formuláře bez návrhů.
Multiselect Uživatelé můžou vybrat více než jednu hodnotu z předdefinovaného seznamu.
Dynamický rozevírací seznam Naplní volby z uloženého dotazu místo statického seznamu.
Rozsah data a časového razítka Definuje počáteční a koncový rozsah pomocí .min a .max parametrů.

Textové zadání

Přijímá hodnotu volného formuláře přímo od uživatele. Tento widget použijte, pokud nejsou potřeba žádné předdefinované možnosti.

SELECT * FROM samples.tpch.region WHERE r_name = :region_param

Zobrazí předdefinovaný seznam hodnot. Uživatelé musí vybrat ze seznamu – položka volného formuláře není povolená. Do podokna nastavení zadejte povolené hodnoty v jednom řádku.

SELECT * FROM samples.tpch.orders WHERE o_orderstatus = :status_param

Vytvoření typu widgetu rozevíracího seznamu:

  1. Klikněte na ikonu ozubeného kola vedle widgetu :status_param.
  2. Nastavte typ widgetu na Rozevírací seznam.
  3. Nastavte typ parametru na String.
  4. Do textového pole Choices for parameter value zadejte hodnoty. Klikněte na Přidat nebo stiskněte enter mezi jednotlivými hodnotami.

Pole se seznamem

Představuje předdefinovaný seznam navrhovaných hodnot, ale také umožňuje uživatelům zadat vlastní hodnotu, která není v seznamu. Použijte kombinovaný seznam, pokud jsou běžné možnosti užitečné pro pohodlí, ale chcete povolit volný vstup.

SELECT * FROM samples.tpch.part WHERE p_brand = :brand_param

Vícenásobný výběr

Umožňuje uživatelům vybrat z předdefinovaného seznamu více než jednu hodnotu. Vybrané hodnoty se předají dotazu jako kolekce.

SELECT * FROM samples.nyctaxi.trips WHERE
  array_contains(
    TRANSFORM(SPLIT(:list_parameter, ','), s -> TRIM(s)),
    CAST(dropoff_zip AS STRING)
  )

Přidání možností pro rozevírací seznam s vícenásobným výběrem:

  1. Klikněte na ikonu ozubeného kola vedle widgetu list_parameter.
  2. Nastavte typ widgetu na vícenásobný výběr.
  3. Nastavte typ parametru na String.
  4. Do textového pole Choices for parameter value zadejte hodnoty. Klikněte na Přidat nebo stiskněte enter mezi jednotlivými hodnotami.

Dynamický rozevírací seznam

Poznámka:

Dynamické rozevírací widgety jsou dostupné jenom v editoru SQL, ne v poznámkových blocích.

Naplní seznam voleb z uloženého dotazu místo statického seznamu. S tím, jak se podkladová data mění, se dostupné možnosti aktualizují automaticky.

K použití dynamického rozevíracího seznamu:

  1. Vytvořte a uložte dotaz, který vrátí požadované hodnoty v rozevíracím seznamu:

    SELECT DISTINCT c_mktsegment FROM samples.tpch.customer ORDER BY c_mktsegment

  2. V novém nebo existujícím dotazu přidejte pojmenovanou značku parametru:

    SELECT c_custkey, c_name, c_acctbal
FROM samples.tpch.customer
WHERE c_mktsegment = :segment_param

  3. Klikněte na ikonu ozubeného kola vedle widgetu segment_param.

  4. Nastavte typ widgetu na dynamický rozevírací seznam.

  5. Kliknutím na pole Dotaz otevřete dialogové okno Vybrat existující dotaz . Vyberte uložený dotaz z kroku 1 a potom klikněte na Vybrat.

  6. Zvolte výchozí hodnotu parametru.

  7. Klikněte na Použít změny.

Rozsah dat a časových razítek

Parametry datum a časové razítko podporují typ widgetu Rozsah. Když je tato možnost vybraná, Azure Databricks vytvoří dva parametry s použitím .min a .max přípon, které definují začátek a konec rozsahu.

SELECT * FROM samples.nyctaxi.trips
WHERE tpep_pickup_datetime
BETWEEN CAST(:date_range_min AS TIMESTAMP) AND CAST(:date_range_max AS TIMESTAMP)

Kliknutím na ikonu modrého blesku vyberte dynamické hodnoty, například today, yesterday, this weeklast week, , last monthnebo last year. Tyto hodnoty se aktualizují automaticky.

Důležité

Dynamické hodnoty kalendářních dat nejsou kompatibilní s naplánovanými dotazy.

  • Last updated on