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 StormEventsmintagyű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:

1. Váltás megtekintési módról szerkesztési módra.

   

2. Válassza a Paraméterek gombot az irányítópult tetején.

   

3. Válassza az + Új paraméter gombot a jobb oldali panel tetején.

4. 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: Egyetlen kijelölés: A szűrőben csak egy érték választható ki a paraméter bemeneteként. Többszörös kijelölés: A szűrőben egy vagy több érték választható ki a paraméter bemenete(i)ként. Időtartomány: Lehetővé teszi további paraméterek létrehozását a lekérdezések és irányítópultok idő alapján történő szűréséhez. Alapértelmezés szerint minden irányítópult rendelkezik időtartomány-választóval. Szabad szöveg: Nincs kitöltve érték a szűrőben. A felhasználó beírhat egy értéket, vagy másolhat/beilleszthet egy értéket a szövegmezőbe. A szűrő megőrzi a legutóbb használt értékeket.
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: Rögzített értékek: Statikus szűrőértékek manuális bevezetése. Lekérdezés: Dinamikusan bevezetett értékek KQL-lekérdezéssel.
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

1. A Paraméterek panel megnyitásához válassza a Paraméterek lehetőséget, majd az Új paraméter lehetőséget.

2. 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

3. 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

1. 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.

2. 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

1. A Paraméterek panel megnyitásához válassza a Paraméterek lehetőséget, majd az Új paraméter lehetőséget.

2. 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

3. 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

1. 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.

2. 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

1. A Paraméterek panel megnyitásához válassza a Paraméterek lehetőséget, majd az Új paraméter lehetőséget.

2. 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

3. 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

1. 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.

2. 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

1. 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.

2. 1. 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

3. 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

1. 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.

2. 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

1. 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.

2. 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

1. 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

1. 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.

2. 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

3. 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

1. Lépjen egy új vagy meglévő csempe lekérdezésére.

2. 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.

3. Válassza a Módosítások alkalmazása lehetőséget.

4. 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.

1. Keresse meg annak a csempének a lekérdezését, amelyhez keresztszűrőket szeretne hozzáadni.

2. Válassza a Vizualizáció lehetőséget.

3. A jobb oldali panelen válassza az Interakciók lehetőséget, majd kapcsolja be a keresztszűrőket.

4. 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.

5. 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.

1. 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.

2. A jobb oldali panelen válassza az Interakciók lehetőséget, majd kapcsolja be a részletezés funkciót.

   

3. 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.

Kapcsolódó tartalom

• Azure Data Explorer-irányítópultok vizualizációinak testreszabása
• Kusto lekérdezésnyelv lekérdezések írása a webes felhasználói felületen