Gyakorlat: Irányítópult-paraméter létrehozása

Befejeződött

Ebben a leckében létrehoz egy paramétert az irányítópult-vizualizációk szűréséhez.

Paraméter létrehozása

Először át kell váltania a megtekintési módról a szerkesztési módra.

  1. Válassza a Megtekintés lehetőséget, és állítsa a módot szerkesztésre.

    Screenshot of switching to editing mode.

  2. A felső menüsávon válassza a [@] Paraméterek lehetőséget. Megnyílik a Paraméterek panel.

  3. Select + New parameter

  4. Töltse ki a paraméterbeállításokat a Paraméter hozzáadása panelen az alábbiak szerint:

    Screenshot of parameter options.

    Mező Leírás Ajánlott érték
    Címke Az irányítópulton vagy a szerkesztési kártyán látható paraméter neve. Állapot
    Paramétertípus Egyetlen kijelölés: A szűrőben csak egy érték választható ki a paraméter bemeneteként.
    Több kijelölés: Egy vagy több érték kiválasztható a szűrőben a paraméter bemenete(i)ként.
    Időtartomány: A lekérdezések és irányítópultok szűrése az idő alapján.
    Szabad szöveg: A felhasználó beírhat egy értéket, vagy másolhat/beilleszthet egy értéket a szövegmezőbe.
    Több kijelölés
    Változó neve A lekérdezésben használni kívánt paraméter neve. _Állami
    Adattípus A paraméterértékek adattípusa. húr
    Megjelenítés a lapokon Jelölje ki azokat a lapokat, ahol ez a paraméter jelenik meg. Az összes kijelölése
    Forrás Rögzített értékek: Manuálisan bevezetett statikus szűrőértékek.
    Lekérdezés: Dinamikusan bevezetett értékek KQL-lekérdezéssel.
    Lekérdezés
    Adatforrás Egy lekérdezésalapú paraméter forrása. Lásd: Lekérdezés szerkesztése.

Paraméterforrás-lekérdezés szerkesztése

Ehhez a paraméterhez létre kell hoznia egy listát a lehetséges értékekről. A létrehozott paraméter neve State. Ezzel szeretné szűrni az eredményeket az esemény bekövetkezésének állapota alapján. Manuálisan megadhatja az összes lehetséges állapot listáját, egyszerűbb azonban olyan lekérdezést használni, amely dinamikusan adja vissza ezt a listát.

  1. Az adatforrásban válassza ki a Minták adatbázist .

  2. A Lekérdezés eredménye mezőben válassza a Lekérdezés szerkesztése lehetőséget.

  3. Másolja/illessze be a következő lekérdezést a szerkesztőbe:

    StormEvents
    | distinct (State)
    
  4. Válassza a Futtatás lehetőséget. Ez a lekérdezés az állapot oszlop összes különböző értékének listáját adja vissza.

    Screenshot of editing query for parameter.

  5. Válassza a Hozzáadás lehetőséget a Paraméter hozzáadása párbeszédpanelre való visszatéréshez.

  6. Válassza ki az Alapértelmezett érték legördülő menüt, és válasszon egy állapotot (például Minnesota).

    Screenshot of source to add query.

  7. Válassza a Kész lehetőséget.

Mindkét csempe-lekérdezés szerkesztése paraméter hozzáadásához

Létrehozott egy paramétert, de az irányítópult ugyanúgy néz ki. A vizualizációt létrehozó lekérdezésben a paramétert kell használnia.

Események dátum szerint

  1. Az Események dátum szerint csempén válassza a ceruza ikont.

    Screenshot of editing the query in the tile.

  2. Használja a paraméterbeállításokban definiált változónevet szűrőként a lekérdezésben. Ebben az esetben a változó neve állapot. Szerkessze a lekérdezést a következő sor belefoglalásához:

    | where State has_any (_state)
    

    A lekérdezésnek a következő képhez hasonlóan kell kinéznie:

    Screenshot of editing the query to add parameter.

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

Eseményszám állapot szerint

  1. Az Eseményszám állapot szerint csempén válassza a ceruza ikont.

  2. Szerkessze a lekérdezést a következő sor belefoglalásához:

    | where State has_any (_state)
    

    A lekérdezésnek a következő képhez hasonlóan kell kinéznie:

    Screenshot of query in dashboard visual including parameter.

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

A paraméter használata

Válassza ki az Állapot paramétert, majd válassza ki a legördülő menü egyik beállítását, például TEXAS. Győződjön meg róla, és törölje az alapértelmezett érték jelölését, hogy csak egy állapot legyen kijelölve. Figyelje meg, hogyan változnak a vizualizációk úgy, hogy csak a kijelölt állapothoz társított adatok jelenjenek meg.

Animated gif showing how to use the parameter picker.