Käytä parametreja Real-Time Dashboard-kyselyissä

Parametrit ovat suodattimien rakennuspalikoita Real-Time Dashboardeissa. Hallinnoit niitä hallintapaneelitasolla ja lisäät ne kyselyihin suodattaaksesi visuaalissa näkyvää dataa. Kysely voi käyttää yhtä tai useampaa parametria.

Tässä artikkelissa selitetään, miten parametrit, ristiinsuodattimet ja harjoitukset luodaan ja käytetään hallintapaneelissa. Voit suodattaa kojelaudan visuaaleja joko valitsemalla parametriarvot suodatinpalkista tai käyttämällä ristiinsuodattimia.

Tässä artikkelissa käytetyt kyselyesimerkit perustuvat Sääanalyysimalli-valikoiman Sääanalyysimallit-taulukon StormEvents-taulukkoon.

Muistiinpano

Voit hallita parametreja vain muokkaustilassa kojelaudan muokkaajissa. Dashboardin parametrit suodattavat visuaaleja, joiden kyselyt käyttävät näitä parametreja. Parametrit eivät suodata tai muuten muokkaa Fabric Maps -laattoja.

Edellytykset

Parametrien käyttäminen kyselyssä

Kyselyssä täytyy käyttää parametria ennen kuin suodatin vaikuttaa kyseiseen visuaaliin. Kun määritit parametrin, näet sen Query-sivun suodatinpalkissa ja IntelliSense-kyselyssä.

Muistiinpano

Jos kysely ei käytä parametria, suodatin pysyy passiivisena. Kun lisäät parametrin kyselyyn, suodatin aktivoituu.

Parametrityypit

Hallintapaneeli tukee seuraavia parametrityyppejä:

Seuraavissa esimerkeissä kuvataan, miten voit käyttää parametreja kyselyssä eri parametrityypeille.

Oletusaika-alueparametri

Jokaisessa dashboardissa on oletuksena aikaväliparametri . Se näkyy suodattimena vain, kun käytät sitä kyselyssä. Käytä _startTime avainsanaa _endTime ja soveltaaksesi oletusaikaväliparametria, kuten seuraavassa esimerkissä on esitetty:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Kun tallennat kyselyn, aikavälisuodatin ilmestyy hallintapaneeliin. Voit sitten suodattaa visuaalin valitsemalla esiasetuksen Aika-alueella tai valitsemalla Mukautettu aikaväli.

Kuvakaappaus aikavälisuodattimesta, jossa on valittu mukautettu alue.

Yksittäisen valinnan kiinteät arvot -parametrit

Kiinteän arvon parametrit perustuvat ennalta määriteltyihin arvoihin, jotka olet määrittänyt. Seuraava esimerkki näyttää, miten luodaan yksivalintainen, kiinteäarvoinen parametri.

Luo yksivalintainen fixed-values-parametri

  1. Valitse Parametrit avataksesi Parametrit-paneelin ja valitse sitten Uusi parametri.

  2. Anna seuraavat tiedot:

    • Otsikko: Tapahtumatyyppi

    • Parametrityyppi: Yksittäinen valinta

    • Muuttujan nimi: _eventType

    • Tietotyyppi: Merkkijono

    • Kiinnitä hallintapaneelin suodattimeksi: Valittu

    • Lähde: Kiinteät arvot

      Käytä tässä esimerkissä seuraavia arvoja:

      Arvo Parametrin näyttönimi
      Ukkosmyrskytuuli Ukkosmyrskytuuli
      Rakeet Rakeet
      Hyökytulva Hyökytulva
      Kuivuus Kuivuus
      Talven sää Talven sää

    • Lisää Valitse kaikki -arvo: Valitsematon

    • Oletusarvo: Ukkosmyrskytuuli

  3. Luo parametri valitsemalla Valmis .

Parametri näkyy Parametrit-paneelissa, mutta et vielä käytä sitä missään visuaalisessa kuvassa.

Käytä yksivalintaista fixed-values-parametria

  1. Suorita esimerkkikysely, joka käyttää uutta Event Type -parametria käyttämällä _eventType muuttujan nimeä:

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType == _eventType
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

    Uusi parametri näkyy mittarilistassa kojelaudan yläosassa.

  2. Valitse eri arvoja visualisointien päivittämiseksi.

    Kuvakaappaus viidestä parhaasta tapahtumatyypistä osavaltioittain.

Monivalintaiset kiinteät arvot -parametrit

Kiinteän arvon parametrit perustuvat ennalta määriteltyihin arvoihin, jotka olet määrittänyt. Seuraava esimerkki näyttää, miten luodaan ja käytetään monivalintainen kiinteäarvoinen parametri.

Luo monivalintainen fixed-values-parametri

  1. Valitse Parametrit avataksesi Parametrit-paneelin ja valitse sitten Uusi parametri.

  2. Täytä yksityiskohdat, kuten kuvataan kohdassa Luo yksivalintainen kiinteäarvoinen parametri, seuraavilla muutoksilla:

    • Otsikko: Tapahtumatyyppi
    • Parametrityyppi: Useita valintoja
    • Muuttujan nimi: _eventType

  3. Luo parametri valitsemalla Valmis .

Uusi parametri näkyy Parametrit-paneelissa, mutta et vielä käytä sitä missään visuaaleissa.

Käytä monivalintaista fixed-values-parametria

  1. Suorita esimerkkikysely, joka käyttää uutta Event Type -parametria ja muuttujaa _eventType .

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

    Uusi parametri näkyy mittarilistassa kojelaudan yläosassa.

  2. Päivitä visualisoinnit valitsemalla yksi tai useampi eri arvo.

    Kuvakaappaus useiden tapahtumatyyppien valinnasta suodattimessa.

Yksivalintaiset kyselypohjaiset parametrit

Kyselypohjaiset parametriarvot noudetaan koontinäytön lataamisen aikana suorittamalla parametrikysely. Seuraavassa esimerkissä näytetään, miten voit luoda yksivalintaisen kyselypohjaisen parametrin ja käyttää sitä.

Kyselypohjaisen parametrin käyttämiseksi lapsisuodattimena, jonka arvot riippuvat toisesta parametrista, katso Luo ketjuparametrit.

Yksittäinen valinta -kyselypohjaisen parametrin luominen

  1. Valitse Parametrit avataksesi Parametrit-paneelin ja valitse sitten Uusi parametri.

  2. Täytä yksityiskohdat, kuten kuvataan kohdassa Luo yksivalintainen kiinteäarvoinen parametri, seuraavilla muutoksilla:

    • Selite: Osavaltio

    • Muuttujan nimi: _state

    • Lähde: Kysely

    • Tietolähde: StormEventsSample

    • Valitse Muokkaa kyselyä ja kirjoita seuraava kysely. Valitse Valmis.

      StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents
| project State

    • Arvo: Osavaltio

    • Näyttönimi: Osavaltio

    • Oletusarvo: Valitse oletusarvo

  3. Luo parametri valitsemalla Valmis .

Yksivalintaisen kyselypohjaisen parametrin käyttäminen

  1. Seuraava uuden Osavaltio-parametrin mallikysely käyttää -muuttujaa _state :

    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

    Uusi parametri näkyy mittarilistassa kojelaudan yläosassa.

  2. Valitse eri arvoja visualisointien päivittämiseksi.

Monivalintakyselypohjaiset parametrit

Kyselypohjaiset parametriarvot saadaan käyttäjän määrittelemästä kyselystä, kun kojelauta latautuu. Seuraava esimerkki näyttää, miten luodaan monivalintakyselyyn perustuva parametri.

Monivalintaisen kyselypohjaisen parametrin luominen

  1. Valitse Parametrit avataksesi Parametrit-paneelin ja valitse sitten + Uusi parametri.

  2. Syötä tiedot kuten kuvataan kohdassa Luo yksivalintakyselypohjainen parametri, seuraavin muutoksin:

    • Selite: Osavaltio
    • Parametrityyppi: Useita valintoja
    • Muuttujan nimi: _state

  3. Luo parametri valitsemalla Valmis .

Monivalintaisen kyselypohjaisen parametrin käyttäminen

  1. Seuraava mallikysely käyttää uutta Osavaltio-parametria -muuttujan _state avulla.

    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

    Muistiinpano

    Tämä malli käyttää Valitse kaikki -vaihtoehtoa tarkistamalla tyhjät arvot -funktiolla isempty() .

    Uusi parametri näkyy mittarilistassa kojelaudan yläosassa.

  2. Päivitä visualisoinnit valitsemalla yksi tai useampi eri arvo.

Vapaatekstiparametrit

Maksuttoman tekstin parametrit eivät sisällä mitään arvoja. Niiden avulla voit esitellä oman arvosi.

Luo ilmainen tekstiparametri

  1. Valitse Parametrit avataksesi Parametrit-paneelin ja valitse sitten + Uusi parametri.
  2. Anna seuraavat tiedot:
    • Selite: Osavaltio
    • Parametrityyppi: Vapaa teksti
    • Muuttujan nimi: _state
    • Tietotyyppi: Merkkijono
    • Oletusarvo: Ei oletusarvoa
  3. Luo parametri valitsemalla Valmis .

Vapaan tekstiparametrin käyttäminen

  1. Suorita mallikysely käyttämällä uutta Osavaltio-parametria käyttämällä muuttujan _state nimeä:

    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

Tietolähteen parametrit

Kun olet lisännyt tietolähteitä hallintapaneeliisi, voit luoda parametrin, joka valitsee yhden tai useamman saatavilla olevasta tietolähteestä. Käytä tätä parametria laatoissa ja muissa parametreissa.

Tietolähdeparametrin luominen

  1. Valitse Parametrit avataksesi Parametrit-paneelin ja valitse sitten + Uusi parametri.

  2. Anna seuraavat tiedot:

    • Label: Lähde
    • Parametrityyppi: Tietolähde
    • Näytä sivuilla: Valitse kaikki
    • Arvot: Valitse kaikki
    • Oletusarvo: StormEvents

    Näyttökuva tietolähteen parametreista.

  3. Valitse Valmis.

Kojelaudan yläosassa oleva parametrilista näyttää nyt uuden parametrin.

Tietolähdeparametrin käyttäminen

  1. Mene hakemaan uutta tai olemassa olevaa laattaa.

  2. Valitse Lähde-kohdassa uuden parametrin nimi Tietolähteen parametrit -kohdassa, kuten uusi Lähde-parametri.

    Näyttökuva tietolähdeparametrin valitsemisesta kyselyssä.

  3. Valitse Ota muutokset käyttöön.

  4. Vaihda tämän yhdistetyn kyselyn tietolähde Lähde-parametrin avulla.

Käytä suodatinhakua yksittäis- ja monivalintasuodattimiin

Yksivalinta- ja monivalintasuodattimissa kirjoita haluamasi arvo. Suodatin päivittyy näyttämään vain hakutermiä vastaavat arvot.

Liittyvä sisältö

  • Viimeksi päivitetty