Megosztás a következőn keresztül:

Irányítópult-paraméterek használata

  • Cikk

Ez a cikk azt ismerteti, hogyan használhatók paraméterek az AI/BI-irányítópultokon. Ha inkább a mezőszűrőket szeretné megismerni, olvassa el a Mezők szűrése című témakört.

Az AI/BI irányítópult paraméterei lehetővé teszik a különböző értékek helyettesítését az adathalmaz-lekérdezésekbe futásidőben. Ez lehetővé teszi az adatok olyan feltételek szerinti szűrését, mint a dátumok és a termékkategóriák, mielőtt az adatok összesítve lesznek egy SQL-lekérdezésben, ami hatékonyabb lekérdezést és pontosabb elemzést eredményez. A paraméterek szűrő widgetekkel interaktívsá teszik az irányítópultokat, vagy vizualizációs widgetekkel megkönnyítik az adathalmazok újrafelhasználását.

Az irányítópult-szerzők vagy szerkesztők paramétereket adnak az adathalmazokhoz, és csatlakoztatják őket egy vagy több widgethez az irányítópult vásznán. A vizualizációs vezérlőkben beállított statikus paraméterek esetében az értékeket a szerzők vagy a szerkesztők állítják be. A szűrő widgetekben használt paraméterek esetében az irányítópult-megjelenítők a futásidőben a szűrő widgetek értékeinek kiválasztásával kezelhetik az adatokat. Ez az interakció újrafuttatja a társított lekérdezéseket, és a szűrt adatok alapján jeleníti meg a vizualizációkat.

A paraméterek közvetlenül módosítják a lekérdezést, ami hatékony lehet. Az adathalmaz mezőszűrői irányítópult-interaktivitást, több funkciót és jobb teljesítményt kínálnak a paramétereknél nagyobb adathalmazokkal. Lásd: Szűrők használata.

Paraméter hozzáadása lekérdezéshez

Legalább SZERKESZTÉSi engedélyekkel kell rendelkeznie a piszkozat-irányítópulton ahhoz, hogy paramétert adjon hozzá egy irányítópult-adatkészlethez. Az Adat lapon közvetlenül adhat hozzá paramétereket az adathalmaz-lekérdezésekhez.

A GIF a következő lépésekre mutat példát.

Paraméter hozzáadása lekérdezéshez:

  1. Helyezze a kurzort arra a helyre, ahová a paramétert el szeretné helyezni a lekérdezésben.

  2. Új paraméter beszúrásához kattintson a Paraméter hozzáadása gombra.

    Ez létrehoz egy új paramétert az alapértelmezett névvel parameter. Az alapértelmezett név módosításához cserélje le a lekérdezésszerkesztőben. Paraméterek hozzáadásához írja be ezt a szintaxist a lekérdezésszerkesztőbe.

Lekérdezési paraméter szerkesztése

Paraméter szerkesztése:

  1. Kattintson Fogaskerék ikon a paraméter neve mellett. Megjelenik egy Paraméter részletei párbeszédpanel, amely a következő konfigurációs beállításokat tartalmazza:
    • Kulcsszó: A lekérdezés paraméterét képviselő kulcsszó. Ez csak a lekérdezés szövegének közvetlen frissítésével módosítható.
    • Megjelenítendő név: A szűrőszerkesztő neve. Alapértelmezés szerint a cím megegyezik a kulcsszóval.
    • Típus: A támogatott típusok közé tartozik a sztring, a dátum, a dátum és az idő, a numerikus.
      • Az alapértelmezett típus a Sztring.
      • A numerikus adattípus lehetővé teszi a decimális és az egész szám közötti beállítás megadását. Az alapértelmezett numerikus típus a Decimális.
  2. A párbeszédpanel bezárásához kattintson a felhasználói felület egy másik részére.

Alapértelmezett paraméterérték beállítása

A lekérdezés futtatásához válasszon egy alapértelmezett értéket a paraméterhez, ha beírja a paraméter neve alatti szövegmezőbe. Futtassa a lekérdezést a lekérdezés eredményeinek előnézetéhez az alkalmazott paraméterértékkel. A lekérdezés futtatása az alapértelmezett értéket is menti. Ha ezt a paramétert szűrő widget használatával állítja be a vászonon, a rendszer az alapértelmezett értéket használja, kivéve, ha a szűrő widgetben új alapértelmezett érték van megadva. Lásd: Szűrők használata.

Lekérdezésalapú paraméterek

A lekérdezésalapú paraméterek lehetővé teszik a szerzők számára, hogy dinamikus vagy statikus értéklistát adjanak meg azoknak az értékeknek a meghatározásához, amelyek közül a megtekintők választhatnak, amikor paramétereket állítanak be az irányítópulton lévő adatok feltárásakor. Ezek egy mezőszűrő és egy paraméterszűrő egyetlen szűrő widgetben való kombinálásával vannak definiálva.

Lekérdezésalapú paraméter létrehozásához az irányítópult szerzője a következő lépéseket hajtja végre:

  1. Hozzon létre egy adatkészletet, amelynek eredményhalmaza a lehetséges paraméterértékek listájára korlátozódik.
  2. Hozzon létre egy paramétert használó adathalmaz-lekérdezést.
  3. Konfiguráljon egy szűrő widgetet a vásznon, amely egy mezőre szűr, és egy paramétert használ.
    • A Mezők konfigurációt úgy kell beállítani, hogy a mező a megfelelő paraméterértékek kívánt listájával legyen használva.
    • A paraméterek konfigurációját paraméterérték kiválasztására kell beállítani.

Feljegyzés

Ha a lekérdezésalapú paraméterekben használt adathalmazt az irányítópult más vizualizációiban is használják, a megtekintő szűrőválasztása módosítja az összes csatlakoztatott lekérdezést. Ennek elkerülése érdekében a szerzőknek dedikált adatkészletet kell létrehozniuk olyan lekérdezésalapú paraméterekhez, amelyeket nem használnak az irányítópult más vizualizációiban.

A lekérdezésalapú paraméterek és vizualizációk hozzáadását bemutató részletes oktatóanyag a lekérdezésalapú paraméterek és vizualizációk használatát mutatja be.

Dinamikus paraméterlista létrehozása

Ha olyan dinamikus adatkészletet szeretne létrehozni, amely feltölti a megtekintők által a paraméterértékek kiválasztásához használt legördülő elemet, írjon egy SQL-lekérdezést, amely egyetlen mezőt ad vissza, és tartalmazza a mező összes értékét. A mező minden új értéke automatikusan paraméterkiválasztásként lesz hozzáadva az adathalmaz frissítésekor. Egy példa SQL-lekérdezés a következő:

 SELECT
    DISTINCT c_mktsegment
  FROM
    samples.tpch.customer

Statikus paraméterlista létrehozása

Létrehozhat olyan statikus adatkészletet, amely csak az adathalmazba rögzített értékeket tartalmazza. Egy példa lekérdezés a következő:

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

Szűrőtípusok

Az egyérték- és dátumválasztó szűrők támogatják a beállítási paramétereket. Ha a lekérdezésalapú paramétereket dátumválasztó szűrővel állítja be, a mögöttes lekérdezés eredményeiben megjelenő dátumok fekete színnel jelennek meg. A lekérdezési eredményekben nem szereplő dátumok szürkeek. A felhasználók akkor is választhatnak szürke dátumokat, ha nem szerepelnek az alapul szolgáló lekérdezésben.

Lekérdezési paraméter eltávolítása

Egy paraméter eltávolításához törölje azt a lekérdezésből.

Statikus vezérlőparaméterek

A statikus widget paraméterei közvetlenül egy vizualizációs widgetben vannak konfigurálva, így a szerzők egyenként paraméterezik az azonos adathalmazt használó vizualizációs vezérlőket. Ez lehetővé teszi, hogy ugyanaz az adatkészlet különböző nézeteket jelenítsen meg a vásznon.

A jelen szakaszban szereplő példa egy olyan adatkészleten alapul, amely lekérdezi a táblát samples.nyctaxi.trips . A megadott lekérdezés az egyes utazások távolságát adja vissza, és a csomagfelvétel napját vagy Weekday Weekend. A lekérdezési paraméter attól függően szűri az eredményeket, hogy a felvétel hétköznap vagy hétvégén történt-e.

A lekérdezés szövege a következő kódblokkban található, de az ebben a szakaszban található utasítások a statikus widgetparaméterekkel konfigurált kapcsolódó vizualizációk beállítására korlátozódnak. Az adathalmaz paraméterekkel való beállításával kapcsolatos utasításokért lásd : Paraméter hozzáadása egy lekérdezéshez.


  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

Statikus widgetparaméter hozzáadása vizualizációhoz:

  1. Adjon hozzá egy vizualizációs widgetet a vázlat irányítópult-vászonhoz.

  2. Ha az új widget ki van jelölve, válassza ki a paraméteres adathalmazt a konfigurációs panel Adathalmaz legördülő menüjéből.

  3. Kattintson a Szűrők megjelenítése elemre. A paramétereket tartalmazó adathalmazok esetében megjelenik egy Paraméter szakasz a konfigurációs panelen.

    Egy vizualizációkonfigurációs panel, amelyen a paramter kiválasztásának lehetősége látható.

  4. Kattintson a Paraméterek fejléctől jobbra található pluszjelre, és válasszon egy paramétert a legördülő menüből.

  5. Alapértelmezés szerint a paraméter értéke tükrözi az Adatok lapon található lekérdezésben beállított értéket. Megtarthatja azt, vagy választhat egy új értéket az adathalmazba való helyettesítéshez. Navigáljon el a szövegmezőtől, és jelenítse meg a vizualizációt az új paraméterrel.

  6. Tekintse át az irányítópultot.

    Az alábbi képen két vizualizációs widget látható, mindegyik hisztogramként van konfigurálva statikus widgetparaméterrel. A bal oldali diagram a hétköznapokon kezdődő utazások utazási távolságainak eloszlását mutatja, míg a jobb oldali diagram a hétvégékre vonatkozó adatokat jeleníti meg. Mindkét vizualizáció ugyanazon adatkészleten alapul.

    Két hisztogram, amelyek statikus widgetszintű paraméterek használatára konfigurálva, az alábbiak szerint.

Adatok összehasonlítása szűrőfeltétel használatával

Hozzáadhat egy szűrőfeltételt, amely lehetővé teszi az adatok egy részének összesítéseinek összehasonlítását a teljes adatkészletre alkalmazott összesítésekhez.

Az alábbi példa kiterjeszti az előző lekérdezést egy olyan szűrőfeltételre, amelyben a megadott paraméterérték nem Alljelenik meg az adatokban. A szűrési feltétel első része ugyanúgy működik, mint az előző példában, és olyan eredmények szűrésére szolgál, ahol az egyik vagy Weekenda day_type Weekday másik. A szűrőfeltétel második része ellenőrzi, hogy maga a paraméter egy bizonyos értékre van-e beállítva, ebben az esetben All, amely nem jelenik meg az adatokban. Amikor az adathalmaz-szerkesztőben beállítja az adott paraméter alapértelmezett értékét, akkor hatékonyan megkerüli a szűrőt, ha egyik Weekday sem Weekend ad át értéket.


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'

Ezzel az adatkészlettel három vizualizációs widgetet konfigurálhat, a day_type_param beállítás Allértéke pedig Weekend a következőWeekday. Ezután az irányítópult-megjelenítők összehasonlíthatják a naptípus szerint szűrt adathalmazokat a teljes adathalmazsal.

Az alábbi GIF bemutatja, hogyan hozhat létre gyorsan három diagramot a lekérdezéssel létrehozott adathalmazból.

  1. Az első diagram úgy van konfigurálva, hogy megjelenítse az Utazási távolságok naptípus szerint adatkészletet egy Weekday értékre beállított paraméterértékkel.
  2. Klónozza a diagramot az összes alkalmazott konfiguráció fenntartásához.
  3. A hétvégén végrehajtott utazások adatainak megjelenítéséhez módosítsa a statikus paramétert Weekend értékre.
  4. Klónozza az új diagramot az összes korábban alkalmazott konfiguráció fenntartásához.
  5. Az új diagram paraméterét Állítsa a Mind értékre a hétvégi és a hétköznapi utazások teljes utazásainak távolság szerinti megjelenítéséhez.

Egy gif az előző szövegben leírtak szerint.

Paraméterek megjelenítése az irányítópulton

Szűrő hozzáadása az irányítópult vásznához lehetővé teszi a nézők számára a paraméterértékek kiválasztását és módosítását, hogy interaktívan feltárhassák és elemezzék az adatokat. Ha nem teszi elérhetővé a paramétert az irányítópulton, a megtekintők csak a lekérdezésben beállított alapértelmezett paraméterértéket használó lekérdezési eredményeket látják.

Paraméter hozzáadása az irányítópulthoz:

  1. Kattintson Szűrő ikon a Szűrő hozzáadása (mező/paraméter) elemre.
  2. Kattintson Mező hozzáadása ikon a paraméterek mellett a konfigurációs panelen.
  3. Kattintson arra a paraméternévre, amelyet a megjelenítőnek ezzel a widgettel szeretne használni.

Szűrő widgetek és statikus paraméterek használata

A paraméterek rögzített értékek, amelyeket futásidőben a lekérdezések helyettesítenek. Ha az irányítópult frissítésekkor két vagy több, ugyanarra a paraméterre mutató hivatkozás különböző értékekkel van beállítva, a vizualizációs widgetek hibát jeleznek, amely azt jelzi, hogy melyik paraméter ütköző értékekkel rendelkezik. Ez akkor fordulhat elő, ha több szűrő widget ugyanazt a paramétert használja, vagy ha egy statikus paraméter ütközik egy olyan szűrő widgettel, amely lehetővé teszi a megtekintő kiválasztását.

Ha ugyanabban a lekérdezésben különböző paraméterek tartalék értékeit szeretné beállítani, az alábbi példában szereplőhöz hasonló mintát használhat.


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

Ebben a példában :static_param egy statikus paraméterre hivatkozik, amelyet a vizualizációs vezérlőben és az adathalmaz-szerkesztőben egyaránt "All" értékre kell állítani. A paraméter :dash_param egy dinamikus érték, amelyet egy szűrő widget vezérel az irányítópult vásznán. Ez az utasítás statikus paraméterként megadott értéket keres. Ha egyik sincs beállítva, az visszaesik egy megtekintő által kiválasztott irányítópult paraméterértékére.

Paraméterek belefoglalása az URL-címbe

A paraméterbeállítások az URL-címben vannak tárolva, így a felhasználók megjelölhetik őket az irányítópult állapotának fenntartásához, beleértve az előre beállított szűrőket és paramétereket, vagy megoszthatják másokkal ugyanazon szűrők és paraméterek konzisztens alkalmazása érdekében.

Irányítópult-paraméterek és bajusz lekérdezési paraméterek

Az irányítópult paraméterei ugyanazt a szintaxist használják, mint a nevesített paraméterjelölők. Lásd: Elnevezett paraméterjelölők. Az irányítópultok nem támogatják a bajuszstílus paramétereit.

Szintaxisbeli példák

A paraméterek gyakran használják a dátumok, számok, szöveg, adatbázis-objektumok és JSON-sztringek értékeinek beszúrását. A paraméterek ilyen esetekben való használatát bemutató példákért lásd : Elnevezett paraméterszintaxis-példák

Fontos

Ha lehetővé teszi a megtekintők számára az adatokhoz való hozzáférést paraméterkijelölések, például tábla- vagy katalógusnevek használatával, az bizalmas információk véletlen expozícióját eredményezheti. Ha ezekkel a beállításokkal tesz közzé irányítópultot, az Azure Databricks azt javasolja, hogy ne ágyazza be a hitelesítő adatokat a közzétett irányítópultba.