Lekérdezésalapú paraméterek használata

A cikk végigvezeti a lekérdezésalapú paramétereket használó interaktív irányítópult létrehozásának lépésein. Alapszintű ismeretet feltételez az irányítópultok Azure Databricksen történő létrehozásához. Az irányítópultok létrehozásával kapcsolatos alapszintű útmutatásért tekintse meg az Első lépések című témakört.

Követelmények

  • Ön be van jelentkezve egy Azure Databricks-munkaterületre.
  • Rendelkezik a Databricks SQL-jogosultságával ebben a munkaterületen.
  • Legalább egy vagy több SQL-raktárhoz rendelkezik HOZZÁFÉRÉSSEL.

Irányítópult-adatkészlet létrehozása

Ez az oktatóanyag az Azure Databricks mintakatalógusából generált adatokat használja.

  1. Kattintson Új ikonaz Oldalsáv Új elemére, és válassza az Irányítópult lehetőséget a menüből.

  2. Kattintson az Adatok lapra.

  3. Kattintson az SQL-adatkészlet hozzáadása elemre , és illessze be a következő lekérdezést a szerkesztőbe. Ezután a Futtatás gombra kattintva adja vissza az eredményeket.

    SELECT
      *
    FROM
      samples.tpch.customer
    
  4. Az újonnan definiált adatkészlet automatikusan, névtelen adatkészlet néven lesz automatikusan mentve. Kattintson duplán a címre, majd nevezze át marketingszegmensnek.

Paraméter hozzáadása

A visszaadott értékek szűréséhez hozzáadhat egy paramétert ehhez az adatkészlethez. Ebben a példában a paraméter a következő :segment: . A paraméterszintaxissal kapcsolatos további információkért tekintse meg az irányítópult paramétereinek használata című témakört.

  1. Illessze be a következő WHERE záradékot a lekérdezés alján. A lekérdezés alatt megjelenik egy paraméternévvel segment rendelkező szövegmező.

    WHERE
      c_mktsegment = :segment
    
  2. Írja be BUILDING a lekérdezés alatti szövegmezőbe a paraméter alapértelmezett értékének beállításához.

  3. Futtassa újra a lekérdezést az eredmények vizsgálatához.

Vizualizációs widget konfigurálása

Adjon hozzá vizualizációt az adathalmazhoz a vásznon az alábbi lépések végrehajtásával:

  1. Kattintson a Névtelen lap fülre.
  2. Kattintson a Create Icon gombra, majd a Vizualizáció hozzáadása lehetőségre egy vizualizációs widget hozzáadásához, és az egérrel helyezze el a vásznon.

Az X tengely beállítása

  1. Ha szükséges, válassza a Sáv lehetőséget a Vizualizáció legördülő menüben.
  2. Kattintson ide Mező hozzáadása ikon az X tengely mentén megjelenő adatok kiválasztásához. A keresősávon név alapján kereshet egy mezőt. Válassza a c_nationkey.
  3. Kattintson a kijelölt mező nevére a további konfigurációs beállítások megtekintéséhez.
    • Méretezési típusként válassza a Kategorikus lehetőséget.
    • Az Átalakítás beállításnál válassza a Nincs lehetőséget.

Az Y tengely beállítása

  1. Kattintson Mező hozzáadása ikon az Y tengely mellett, majd válassza a c_acctbal.
  2. Kattintson a kijelölt mező nevére a további konfigurációs beállítások megtekintéséhez.
    • Méretezési típusként válassza a Folyamatos lehetőséget.
    • Az Átalakítás beállításnál válassza a SZUM elemet.

A vizualizáció konfigurálásakor a rendszer automatikusan frissíti a vizualizációt. A megjelenített adatok csak azokat a rekordokat tartalmazzák, ahol a segmentBUILDING.

Az előző lépésekben leírtak szerint konfigurált vizualizációs widget.

Szűrő hozzáadása

Állítson be egy szűrőt, hogy az irányítópult-megjelenítők szabályozhassák, hogy melyik marketingszakaszra összpontosítsanak.

  1. Szűrő widget hozzáadásához kattintson Szűrő ikona Szűrő hozzáadása (mező/paraméter) elemre. Helyezze a vászonra.
  2. A konfigurációs panel Szűrő legördülő menüjében válassza az Egyetlen érték lehetőséget.
  3. A Cím jelölőnégyzet bejelölésével megjeleníthet egy címmezőt a szűrő widgeten.
  4. Kattintson a widget címkéjének helyőrzőjére, és gépelje be a Szegmens szót a szűrő átnevezéséhez.
  5. Kattintson a Mező hozzáadása ikon melletti Paraméterek gombra a konfigurációs panelen.
  6. Válassza ki a szegmenst a Marketing szegmens adatkészletből.

A konfigurált szűrő widget az adathalmaz alapértelmezett paraméterértékét jeleníti meg.

A leírtak szerint paraméterrel konfigurált szűrő widget.

Értékek kiválasztásának definiálása

A létrehozott szűrő működőképes, de a megtekintőnek ismernie kell a rendelkezésre álló választási lehetőségeket, mielőtt beírhat egy kijelölést. Ez azt is megköveteli, hogy a felhasználók figyeljenek a kis- és nagybetűk, valamint a helyesírás betartására a kívánt paraméterérték megadásakor.

Ha egy legördülő listát szeretne létrehozni, hogy a megtekintő kiválaszthasson egy paramétert az elérhető lehetőségek listájából, hozzon létre egy új adatkészletet a lehetséges értékek listájának meghatározásához.

  1. Kattintson az Adatok lapra.

  2. Új adatkészlet létrehozásához kattintson az SQL-adathalmaz hozzáadása elemre.

  3. Másolja és illessze be a következőt a szerkesztőbe:

    SELECT
      DISTINCT c_mktsegment
    FROM
      samples.tpch.customer
    
  4. Futtassa a lekérdezést, és vizsgálja meg az eredményeket. A táblázat öt marketingszegmense jelenik meg az eredmények között.

  5. Kattintson duplán az automatikusan létrehozott címre, majd nevezze át ezt az adathalmazt Szegmens választás.

A szűrő frissítése

Frissítse a meglévő szűrőt úgy, hogy az imént létrehozott adathalmazt használja a felhasználók által választható értékek legördülő listájának feltöltéséhez.

  1. Kattintson a Névtelen lap elemre. Ezután kattintson az előző lépésben létrehozott szűrő widgetre.
  2. Kattintson Mező hozzáadása ikon a Mezők elem mellett.
  3. Kattintson a Szegmens lehetőségre, majd a mező nevére c_mktsegment.

A szűrő widget a konfiguráció módosításakor frissül. Kattintson a szűrő widget mezőjére a legördülő menüben elérhető lehetőségek megtekintéséhez.

Megjegyzés

Ez az oktatóanyag egy egyszerűsített használati esetet tartalmaz, amely bemutatja a lekérdezésalapú paraméterek használatát. Az irányítópult létrehozásának másik módja egy szűrő alkalmazása a c_mktsegment mezőre.

A leírtaknak megfelelően mezővel konfigurált szűrő widget.

Következő lépések

Az irányítópultok használatáról az alábbi cikkekből tájékozódhat: