Irányítópulti paraméterek használata

Az irányítópult-paraméterek az irányítópultok interaktívvá tételének egyik módja, amely lehetővé teszi, hogy a megtekintők egyértékű választókat és dátumválasztókat használjanak adott értékek adathalmaz-lekérdezésekbe való beviteléhez futásidőben. A paraméterek például olyan feltételek alapján szűrhetik az adatokat, mint a dátumok és a termékkategóriák, mielőtt egy SQL-lekérdezésben összesítenék az adatokat, így hatékonyabb lekérdezést és pontosabb elemzést tehetnek lehetővé.

A paramétereket az irányítópult szerzője vagy szerkesztője hozzáadja az adathalmazokhoz, és egy vagy több widgethez csatlakozik az irányítópult vásznán. Az irányítópult-megjelenítők futásidőben a szűrő widgetekben lévő értékek kiválasztásával kezelhetik az irányítópult adatait. Ez újrafuttatja a társított lekérdezéseket, és megjeleníti a szűrt adatokra épülő vizualizációkat.

A paraméterek közvetlenül módosítják a lekérdezést, ami hatékony lehet. Az adathalmazszűrők az irányítópultok közötti 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.

Paraméter hozzáadása

Legalább szerkesztési engedélyekkel kell rendelkeznie a piszkozat irányítópultján 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.

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.

Paraméter szerkesztése

Paraméter szerkesztése:

1. Kattintson a paraméter neve mellett. Megjelenik egy Paraméter részletei párbeszédpanel.

   A párbeszédpanel 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.

Paraméter eltávolítása

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

Paraméter használata az irányítópult vásznán

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

1. Kattintson a Szűrő hozzáadása (mező/paraméter) elemre.
2. Kattintson 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.

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.

Példák a paraméterszintaxisra

(1) Az értékek a függvény használatával format_string vannak beszúrva. Lásd format_string függvényt.

Az alábbi példák egy használati esetet, majd egy mintaszintaxist mutatnak be.

• Csak egy adott dátum előtti rekordokat adjon meg.

  WHERE date_field < :date_param

• Csak az adott ár alatti árakat adja meg.

  WHERE price < :max_price

• Válassza ki a lekérdezésben használni kívánt táblát.

  SELECT * FROM IDENTIFIER(:param)

• Módosítsa a lekérdezésben használt katalógust, sémát és táblát.

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

• Formázott telefonszámok létrehozásához két paramétert egyesíthet szögletes zárójelekkel.

  Az alábbi példa a függvény használatával format_string szúr be értékeket. Lásd format_string függvényt.

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

Fontos

Ha lehetővé teszi az irányítópult-megjelenítők számára, hogy paraméterkijelölésekkel , például tábla- vagy katalógusnevekkel férjenek hozzá az adatokhoz, 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.

Irányítópult-paraméterek és Databricks SQL-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 Databricks SQL-stílus paramétereit.