Paraméterek használata az Azure Data Explorer-irányítópultokon
A paraméterek az Azure Data Explorer-irányítópultok szűrőinek építőelemei. A rendszer az irányítópult hatókörében kezeli őket, és hozzáadhatók a lekérdezésekhez a mögöttes vizualizáció által megjelenített adatok szűréséhez. A lekérdezések egy vagy több paramétert is használhatnak.
Ez a dokumentum a paraméterek és a csatolt szűrők irányítópultokon való létrehozását és használatát ismerteti. A paraméterek az irányítópult-vizualizációk szűrésére használhatók a szűrősáv paraméterértékeinek kiválasztásával vagy keresztszűrők használatával.
A cikkben használt lekérdezési példák a StormEvents
mintagyűjtemény táblázatán alapulnak.
Megjegyzés
A paraméterkezelés szerkesztési módban érhető el az irányítópult-szerkesztők számára.
Előfeltételek
- Adatok ábrázolása Azure Data Explorer-irányítópultokkal
- Szerkesztői engedélyek egy Azure Data Explorer-irányítópulton
- Irányítópult vizualizációkkal
Paraméterek listájának megtekintése
Az összes irányítópult-paraméter listájának megtekintéséhez válassza a Paraméterek gombot az irányítópult tetején.
Paraméter létrehozása
Paraméter létrehozása:
Váltás megtekintési módról szerkesztési módra.
Válassza a Paraméterek gombot az irányítópult tetején.
Válassza az + Új paraméter gombot a jobb oldali panel tetején.
Adja meg a paraméter megfelelő tulajdonságait .
Támogatott tulajdonságok
A Paraméter hozzáadása panelen konfigurálja a következő tulajdonságokat:
Mező | Leírás |
---|---|
Címke | Az irányítópulton vagy a szerkesztőkártyán megjelenő paraméter neve. |
Paramétertípus | Az alábbi paraméterek egyike:
|
Változó neve | A lekérdezésben használni kívánt paraméter neve. Tipp: A változónevek előtagolása megkülönböztető karakterrel, például aláhúzásjellel (_) megkönnyíti a keresésüket a lekérdezések írásakor. |
Adattípus | A paraméterértékek adattípusa. |
Megjelenítés a lapokon | Jelölje ki azokat a lapokat, ahol ez a paraméter megjelenik. Az Összes kijelölése lehetőség az összes oldalon megjeleníti a paramétert. |
Forrás | A paraméterértékek forrása:
|
Alapértelmezett érték | A szűrő alapértelmezett értéke. A szűrő mindig az alapértelmezett értékkel indul az irányítópult kezdeti renderelésekor. |
"Az összes kijelölése" érték hozzáadása | Csak egyetlen kijelölésre és több kiválasztási paramétertípusra alkalmazható. Az összes paraméterérték adatainak lekérésére szolgál. Ezt az értéket be kell építeni a lekérdezésbe a funkció biztosításához. Az ilyen lekérdezések létrehozására további példákért lásd : A többszörös kijelölésű lekérdezésalapú paraméter használata. |
Paraméterek kezelése
Miután kiválasztotta a paramétereket a felső sávon, megtekintheti a meglévő paraméterek listáját. Minden paraméterkártyán válassza ki a ceruza widgetet a paraméter szerkesztéséhez, vagy válassza a Továbbiak [...]menüt a Duplikálás, Törlés vagy a paraméter áthelyezéséhez.
A paraméterkártyán a következő mutatók tekinthetők meg:
- Paraméter megjelenítendő neve
- Változónevek
- Azon lekérdezések száma, amelyekben a paramétert használták
- A paraméterhez rögzített lapok
A paraméterkártyák az áthelyezéssel vagy az Áthelyezés > beállítással és az új hely kiválasztásával rendelhetők meg.
Paraméterek használata a lekérdezésben
A lekérdezésben egy paramétert kell használni ahhoz, hogy a szűrő alkalmazható legyen az adott lekérdezési vizualizációra. A definiálást követően a paraméterek a Lekérdezés lap > szűrő felső sávjában és a lekérdezési intellisense-ben láthatók.
Megjegyzés
Ha a paramétert nem használja a lekérdezés, a szűrő inaktív marad. Miután hozzáadta a paramétert a lekérdezéshez, a szűrő aktívvá válik.
Paramétertípusok
Számos irányítópult-paramétertípus támogatott az alábbiak szerint:
- Alapértelmezett időtartomány-paraméter
- Egykijelölésű rögzített értékek paraméterei
- Többszörös kijelölésű rögzített értékek paraméterei
- Egykijelöléses lekérdezésalapú paraméterek
- Többkijelöléses lekérdezésalapú paraméterek
- Szabad szöveges paraméterek
- Adatforrás paraméterei
Az alábbi példák azt mutatják be, hogyan használhatók paraméterek egy lekérdezésben a különböző paramétertípusokhoz.
Alapértelmezett időtartomány-paraméter
Alapértelmezés szerint minden irányítópult rendelkezik időtartomány-paraméterrel . Az irányítópulton csak akkor jelenik meg szűrőként, ha egy lekérdezésben használják. Használja a paraméter kulcsszavakat _startTime
, és _endTime
használja az alapértelmezett időtartomány-paramétert egy lekérdezésben az alábbi példában látható módon:
StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents
A mentés után megjelenik az időtartomány-szűrő az irányítópulton. Most már a kártyán lévő adatok szűrésére használható. Az irányítópult szűréséhez válassza a következő legördülő menüt: Időtartomány (utolsó x perc/óra/nap) vagy egyéni időtartomány.
Egykijelölésű rögzített értékek paraméterei
A rögzített értékparaméterek a felhasználó által megadott előre megadott értékeken alapulnak. Az alábbi példa bemutatja, hogyan hozhat létre egyetlen kijelölt rögzített érték paramétert.
Egyszeres kijelölésű rögzített értékek paraméterének létrehozása
A Paraméterek panel megnyitásához válassza a Paraméterek lehetőséget, majd az Új paraméter lehetőséget.
Adja meg a részleteket az alábbiak szerint:
Címke: Esemény típusa
Paraméter típusa: Önálló kijelölés
Változó neve:
_eventType
Adattípus: Sztring
Rögzítés irányítópult-szűrőként: bejelölve
Forrás: Rögzített értékek
Ebben a példában használja a következő értékeket:
Érték Paraméter megjelenítendő neve Zivatar szél Zivatar szél Jégeső Jégeső Villámárvíz Villámárvíz Aszály Aszály Téli időjárás Téli időjárás Minden érték kijelölése : Nincs bejelölve
Alapértelmezett érték: Zivatar széle
A paraméter létrehozásához válassza a Kész lehetőséget.
A paraméter a Paraméterek oldalpanelen látható, de jelenleg nem használatos vizualizációkban.
Egy egyszeres kijelölésű rögzített értékek paraméter használata
Futtasson mintalekérdezéseket az új Event TypTope paraméterrel a
_eventType
változó nevével:StormEvents | where StartTime between (_startTime.._endTime) | where EventType == _eventType | summarize TotalEvents = count() by State | top 5 by TotalEvents
Az új paraméter megjelenik az irányítópult tetején található paraméterlistában.
Válasszon ki különböző értékeket a vizualizációk frissítéséhez.
Többszörös kijelölésű rögzített értékek paraméterei
A rögzített értékparaméterek a felhasználó által megadott előre megadott értékeken alapulnak. Az alábbi példa bemutatja, hogyan hozhat létre és használhat többkijelölésű rögzített értékű paramétert.
Többszörös kijelölésű rögzített értékek paramétereinek létrehozása
A Paraméterek panel megnyitásához válassza a Paraméterek lehetőséget, majd az Új paraméter lehetőséget.
Töltse ki az egykijelölésű rögzített értékek paraméter használata az alábbi módosításokkal című cikkben leírtak szerint:
- Címke: Esemény típusa
- Paraméter típusa: Többszörös kijelölés
-
Változó neve:
_eventType
A paraméter létrehozásához válassza a Kész lehetőséget.
Az új paraméterek a Paraméterek oldalpanelen láthatók, de jelenleg nincsenek használatban vizualizációkban.
Többszörös kijelölésű rögzített értékek paraméter használata
Futtasson mintalekérdezéseket az új Eseménytípus paraméterrel a
_eventType
változó használatával.StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | summarize TotalEvents = count() by State | top 5 by TotalEvents
Az új paraméter megjelenik az irányítópult tetején található paraméterlistában.
Jelöljön ki egy vagy több különböző értéket a vizualizációk frissítéséhez.
Egykijelöléses lekérdezésalapú paraméterek
A lekérdezésalapú paraméterértékek lekérése az irányítópult betöltésekor a paraméteres lekérdezés végrehajtásával. Az alábbi példa bemutatja, hogyan hozhat létre és használhat egyetlen választó lekérdezésalapú paramétert.
Egykijelöléses lekérdezésalapú paraméter létrehozása
A Paraméterek panel megnyitásához válassza a Paraméterek lehetőséget, majd az Új paraméter lehetőséget.
Töltse ki az egykijelölésű rögzített értékek paraméter használata az alábbi módosításokkal című cikkben leírtak szerint:
Címke: Állapot
Változó neve:
_state
Forrás: Lekérdezés
Adatforrás: StormEventsSample
Válassza a Lekérdezés szerkesztése lehetőséget, és írja be a következő lekérdezést. Válassza a Kész lehetőséget.
StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | summarize TotalEvents = count() by State | top 5 by TotalEvents | project State
Érték: Állapot
Megjelenítendő név: Állapot
Alapértelmezett érték: Alapértelmezett érték kiválasztása
A paraméter létrehozásához válassza a Kész lehetőséget.
Egykijelöléses lekérdezésalapú paraméter használata
Az új State paraméterrel rendelkező alábbi mintalekérdezés a változót
_state
használja:StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | where State == _state | summarize TotalEvents = count() by State | top 5 by TotalEvents
Az új paraméter megjelenik az irányítópult tetején található paraméterlistában.
Válasszon ki különböző értékeket a vizualizációk frissítéséhez.
Többkijelöléses lekérdezésalapú paraméterek
A lekérdezésalapú paraméterértékek az irányítópult betöltési idejéből származnak a felhasználó által megadott lekérdezés végrehajtásával. Az alábbi példa bemutatja, hogyan hozhat létre többkijelöléses lekérdezésalapú paramétert:
Többkijelöléses lekérdezésalapú paraméter létrehozása
Válassza a Paraméterek lehetőséget a Paraméterek panel megnyitásához, majd válassza az + Új paraméter lehetőséget.
-
- Töltse ki az egykijelölésű rögzített értékek paraméter használata az alábbi módosításokkal című cikkben leírtak szerint:
- Címke: Állapot
- Paraméter típusa: Többszörös kijelölés
-
Változó neve:
_state
A paraméter létrehozásához válassza a Kész lehetőséget.
Többkijelöléses lekérdezésalapú paraméter használata
Az alábbi mintalekérdezés az új State paramétert használja a
_state
változó használatával.StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | where State in (_state) or isempty(_state) | summarize TotalEvents = count() by State | top 5 by TotalEvents
Megjegyzés
Ez a minta az Összes kijelölése lehetőséget használja, ha üres értékeket keres a
isempty()
függvénnyel.Az új paraméter megjelenik az irányítópult tetején található paraméterlistában.
Jelöljön ki egy vagy több különböző értéket a vizualizációk frissítéséhez.
Szabad szöveges paraméterek
Az ingyenes szöveges paraméterek nem tartalmaznak értékeket. Lehetővé teszik a saját értékének bevezetését.
Szabad szöveges paraméter létrehozása
Válassza a Paraméterek lehetőséget a Paraméterek panel megnyitásához, majd válassza az + Új paraméter lehetőséget.
Adja meg a részleteket az alábbiak szerint:
- Címke: Állapot
- Paraméter típusa: Szabad szöveg
- Változó neve: _state
- Adattípus: Sztring
- Alapértelmezett érték: Nincs alapértelmezett érték
Szabad szöveges paraméter használata
Futtasson egy mintalekérdezéseket az új State paraméterrel a
_state
változó nevével:StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | where State contains _state | summarize TotalEvents = count() by State | top 5 by TotalEvents
Adatforrás paraméterei
Miután hozzáadott adatforrásokat az irányítópulthoz, létrehozhat egy paramétert, amely kiválaszt egy vagy több elérhető adatforrást. Ez a paraméter csempékben és más paraméterekben is használható.
Adatforrás-paraméter létrehozása
Válassza a Paraméterek lehetőséget a Paraméterek panel megnyitásához, majd válassza az + Új paraméter lehetőséget.
Adja meg a részleteket az alábbiak szerint:
- Címke: Forrás
- Paraméter típusa: Adatforrás
- Megjelenítés a lapokon: Az összes kijelölése
- Értékek: Az összes kijelölése
- Alapértelmezett érték: StormEventsSample
Válassza a Kész lehetőséget.
Az új paraméter most már látható az irányítópult tetején található paraméterlistában.
Adatforrás-paraméter használata
Lépjen egy új vagy meglévő csempe lekérdezésére.
A Forrás területen válassza ki az új paraméter nevét az Adatforrás paraméterei területen. A fent létrehozott paraméternél válassza a Fürt lehetőséget.
Válassza a Módosítások alkalmazása lehetőséget.
A Fürt paraméterrel módosíthatja a csatlakoztatott lekérdezés adatforrását.
Keresztszűrések paraméterei
A keresztszűrők lehetővé teszik egy érték kiválasztását egy vizualizációban, és minden irányítópult-vizualizáció, például vonal- vagy pontdiagram szűrve van, hogy csak a kapcsolódó adatok jelenjenek meg. A keresztszűrők használata ugyanazt az eredményt éri el, mint az irányítópult tetején található paraméterlista paraméterének megfelelő értékének kiválasztása.
Keresztszűrők definiálása
Keresztszűrő létrehozásához be kell kapcsolnia a vizualizáció beállítását, majd meg kell adnia az adatok szűréséhez használt paramétert.
Keresse meg annak a csempének a lekérdezését, amelyhez keresztszűrőket szeretne hozzáadni.
Válassza a Vizualizáció lehetőséget.
A jobb oldali panelen válassza az Interakciók lehetőséget, majd kapcsolja be a keresztszűrőket.
Igény szerint adja meg az interakció típusát. Az alapértelmezett érték a Pont , ahol kiválaszthat egy értéket a vizualizációban. Ha értéktartományt ( például egy idődiagramot) jelöl ki, válassza az Húzás lehetőséget.
Adja meg a lekérdezés szűréséhez használt értéket és paramétert is.
Fontos
Az oszlopnak és a paraméternek azonos adattípusúnak kell lennie.
Az adatok kezelése keresztszűréssel
A keresztszűrés definiálása után használhatja az adatokkal való interakcióra. Azokban a vizualizációkban, ahol definiált keresztszűrőket, kiválaszthatja az adatpontokat, és azok értékeivel szűrheti az aktuális irányítópult-oldalt. Táblázatos vizualizációk esetén az adatpontok kijelöléséhez kattintson a jobb gombbal a megfelelő cellára, majd a helyi menüben válassza a Keresztszűrés lehetőséget.
A keresztszűrés alaphelyzetbe állításához válassza a vizualizáció tetején található Visszaállítás lehetőséget, ahol a szűrő ki lett választva.
Részletezések használata irányítópult-paraméterekként
A részletezéssel kiválaszthat egy értéket egy vizualizációban, és a használatával szűrheti a vizualizációkat egy céloldalon ugyanazon az irányítópulton. Amikor megnyílik a céllap, az érték előre ki lesz jelölve a megfelelő szűrőkben. A lap vizualizációi, például a vonal- vagy pontdiagramok csak a kapcsolódó adatok megjelenítésére vannak szűrve.
Részletezés definiálása
Részletezés létrehozásához először be kell kapcsolnia a vizualizációban, majd szükség szerint hozzá kell adnia egy vagy több részletezőt.
Szerkessze azt a vizualizációt, amelyhez részletezőt szeretne hozzáadni. Győződjön meg arról, hogy a Vizualizáció lap ki van jelölve.
A jobb oldali panelen válassza az Interakciók lehetőséget, majd kapcsolja be a részletezés funkciót.
A Részletezés területen válassza az Új létrehozása lehetőséget, és adja meg a következő információkat. Másik pár hozzáadása lehetőséget is választhatja, ha több paramétert szeretne hozzáadni egy céloldalhoz. Ismételje meg ezt a lépést, ha részletezéseket szeretne hozzáadni az aktuális irányítópult más lapjaihoz különböző paraméterekkel.
Mező Leírás Céloldal Egy vagy több céloldal, amelyeken áthatolást végezhet a definiált paraméterek használatával. Oszlop A lekérdezés eredményének oszlopa, amelyet egy paraméter értékeként kell használni a céloldalon. Paraméter A céloldal vizualizációinak oszlopértékkel történő szűrésére használt paraméter. Jegyzetek Nem kötelező, rövid leírás. Fontos
Az oszlop- és paraméterpároknak azonos adattípusúnak kell lenniük.
Adatok kezelése részletezésekkel
A részletezések definiálása után használhatja őket az adatok kezeléséhez. Ehhez olyan vizualizációkban vagy táblákban, ahol részletezés van meghatározva, kattintson a jobb gombbal egy adatpontra, majd válassza a Részletezés acéloldalig> lehetőséget. Az adatpont értékei lesznek a céloldal vizualizációinak szűrésére szolgáló paraméterek.
A forráslapra való visszatéréshez a céllap jobb felső sarkában válassza az Alaphelyzetbe állítás lehetőséget. A részletezés által hozzárendelt összes szűrő alaphelyzetbe áll.
Szűrőkeresés használata egyetlen és több kijelölési szűrőhöz
Egy és több kijelölési szűrőbe írja be a kívánt értéket. A szűrő úgy frissül, hogy csak a keresési kifejezésnek megfelelő értékeket jelenítse meg.