Bruk parametere i Real-Time Dashboard-spørringer

Parametere er byggeklossene for filtre i Real-Time dashbord. Du administrerer dem på dashbordnivå og legger dem til i spørringer for å filtrere dataene som vises i en visuell presentasjon. En spørring kan bruke én eller flere parametere.

Denne artikkelen forklarer hvordan man lager og bruker parametere, kryssfiltre og drillthroughs i dashbord. Du kan filtrere dashbordvisuals enten ved å velge parameterverdier i filterlinjen eller ved å bruke kryssfiltre.

Spørringseksemplene som brukes i denne artikkelen, er basert på StormEvents-tabellen i eksempeldataene for væranalyse som er tilgjengelige i eksempelgalleriet.

Merk

Du kan kun administrere parametere i redigeringsmodus for dashbord-editorer. Dashbordparametere filtrerer visualiseringer hvis spørringer bruker disse parameterne. Parametere filtrerer eller endrer på annen måte Fabric Maps-fliser.

Forutsetning

Bruke parametere i spørringen

En parameter må brukes i spørringen før filteret påvirker det visuelle bildet. Etter at du har definert en parameter, kan du se den i filterlinjen på Query-siden og i query IntelliSense.

Merk

Hvis spørringen ikke bruker parameteren, forblir filteret inaktivt. Når du legger til parameteren i spørringen, blir filteret aktivt.

Parametertyper

Dashbordet støtter følgende parametertyper:

Eksemplene nedenfor beskriver hvordan du bruker parametere i en spørring for ulike parametertyper.

Standard parameter for tidsintervall

Hvert dashbord har som standard en tidsområdeparameter . Det vises som et filter bare når du bruker det i en spørring. Bruk og _startTime nøkkelordene _endTime for å anvende standard tidsintervallparameter, som vist i følgende eksempel:

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

Når du lagrer spørringen, vises tidsintervallfilteret på dashbordet. Du kan deretter filtrere det visuelle ved å velge en forhåndsinnstilling i Tidsintervall eller ved å velge Tilpasset tidsintervall.

Skjermbilde av tidsintervallfilteret med et tilpasset område valgt.

Parametere med faste verdier for enkeltvalg

Faste verdiparametere er basert på forhåndsdefinerte verdier du spesifiserer. Følgende eksempel viser hvordan man oppretter en enkelt-seleksjons, fastverdi-parameter.

Opprette en parameter for faste verdier med ett utvalg

  1. Velg Parametere for å åpne Parameter-panelet , og velg deretter Ny parameter.

  2. Skriv inn følgende detaljer:

    • Etikett: Hendelsestype

    • Parametertype: Enkeltvalg

    • Variabelnavn: _eventType

    • Datatype: Streng

    • Pin som dashbordfilter: Valgt

    • Kilde: Faste verdier

      Bruk følgende verdier i dette eksemplet:

      Verdi Visningsnavn for parameter
      Tordenvær Vind Tordenvær vind
      Hagl Hagl
      Blitsflom Blitsflom
      Tørke Tørke
      Vintervær Vintervær

    • Legg til en Merk alle-verdi : Ikke avmerket

    • Standardverdi: Tordenvær

  3. Velg Fullført for å opprette parameteren.

Parameteren vises i Parameter-panelet , men du bruker den ikke i noen visuelle effekter ennå.

Bruk en parameter for faste verdier med ett utvalg

  1. Kjør en eksempelspørring som bruker den nye hendelsestype-parameteren ved å bruke _eventType variabelnavnet:

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

    Den nye parameteren vises i parameterlisten øverst på dashbordet.

  2. Velg forskjellige verdier for å oppdatere visualobjektene.

    Skjermbilde av de fem beste arrangementstypene etter delstat.

Parametere med faste verdier med flere valg

Faste verdiparametere er basert på forhåndsdefinerte verdier du spesifiserer. Følgende eksempel viser hvordan man oppretter og bruker en flervalgsparameter med fast verdi.

Opprette en flervalgsparameter for faste verdier

  1. Velg Parametere for å åpne Parameter-panelet , og velg deretter Ny parameter.

  2. Fyll inn detaljene som beskrevet i Opprett en enkeltvalgsparameter med faste verdier, med følgende endringer:

    • Etikett: Hendelsestype
    • Parametertype: Flervalg
    • Variabelnavn: _eventType

  3. Velg Fullført for å opprette parameteren.

Den nye parameteren vises i parameterpanelet , men du bruker den ikke i noen visuelle effekter ennå.

Bruke en flervalgsparameter for faste verdier

  1. Kjør en eksempelspørring som bruker den nye Event Type-parameteren og variabelen _eventType .

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

    Den nye parameteren vises i parameterlisten øverst på dashbordet.

  2. Velg én eller flere forskjellige verdier for å oppdatere visualobjektene.

    Skjermbilde av å velge flere hendelsestyper i filteret.

Spørringsbaserte parametere for enkeltvalg

Spørringsbaserte parameterverdier hentes under innlasting av instrumentbord ved å kjøre parameterspørringen. Følgende eksempel viser deg hvordan du oppretter og bruker en enkeltvalgs, spørringsbasert parameter.

For å bruke en spørringsbasert parameter som et barnefilter hvis verdier avhenger av en annen parameter, se Opprett kaskaderende parametere.

Opprette en enkeltvalgsspørringsbasert parameter

  1. Velg Parametere for å åpne Parameter-panelet , og velg deretter Ny parameter.

  2. Fyll inn detaljene som beskrevet i Opprett en enkeltvalgsparameter med faste verdier, med følgende endringer:

    • Etikett: Delstat

    • Variabelnavn: _state

    • Kilde: Spørring

    • Datakilde: StormEventsSample

    • Velg Rediger spørring, og skriv inn følgende spørring. Velg Ferdig.

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

    • Verdi: Delstat

    • Visningsnavn: Tilstand

    • Standardverdi: Velg en standardverdi

  3. Velg Fullført for å opprette parameteren.

Bruke en spørringsbasert parameter for enkeltvalg

  1. Følgende eksempelspørring med den nye tilstandsparameteren bruker variabelen _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

    Den nye parameteren vises i parameterlisten øverst på dashbordet.

  2. Velg forskjellige verdier for å oppdatere visualobjektene.

Spørringsbaserte parametere med flere valg

Spørringsbaserte parameterverdier kommer fra å kjøre en brukerspesifisert spørring når dashbordet lastes. Følgende eksempel viser hvordan man oppretter en parameter, basert på flerutvalg av spørsler.

Opprette en flervalgsspørringsbasert parameter

  1. Velg Parametere for å åpne Parameter-panelet , og velg deretter + Ny parameter.

  2. Skriv inn detaljene som beskrevet i Opprett en enkeltvalgsbasert spørringsparameter, med følgende endringer:

    • Etikett: Delstat
    • Parametertype: Flervalg
    • Variabelnavn: _state

  3. Velg Fullført for å opprette parameteren.

Bruke en flervalgsspørringsbasert parameter

  1. Følgende eksempelspørring bruker den nye tilstandsparameteren ved hjelp av variabelen _state .

    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

    Merk

    Dette eksemplet bruker alternativet Velg alt ved å se etter tomme verdier med isempty() funksjonen.

    Den nye parameteren vises i parameterlisten øverst på dashbordet.

  2. Velg én eller flere forskjellige verdier for å oppdatere visualobjektene.

Parametere for fri tekst

Parametere for fri tekst inneholder ingen verdier. De lar deg introdusere din egen verdi.

Opprette en fri tekstparameter

  1. Velg Parametere for å åpne Parameter-panelet , og velg deretter + Ny parameter.
  2. Skriv inn følgende detaljer:
    • Etikett: Delstat
    • Parametertype: Fri tekst
    • Variabelnavn: _state
    • Datatype: Streng
    • Standardverdi: Ingen standardverdi
  3. Velg Fullført for å opprette parameteren.

Bruke en fri tekstparameter

  1. Kjør en eksempelspørring ved hjelp av den nye tilstandsparameteren_state ved hjelp av variabelnavnet:

    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

Datakildeparametere

Etter at du har lagt til datakilder i dashbordet, kan du lage en parameter som velger én eller flere av de tilgjengelige datakildene. Bruk denne parameteren i fliser og andre parametere.

Opprette en datakildeparameter

  1. Velg Parametere for å åpne Parameter-panelet , og velg deretter + Ny parameter.

  2. Skriv inn følgende detaljer:

    • Etikett: Kilde
    • Parametertype: Datakilde
    • Vis på sider: Merk alle
    • Verdier: Merk alle
    • Standardverdi: StormEvents

    Skjermbilde av datakildeparametere.

  3. Velg Ferdig.

Parameterlisten øverst på dashbordet viser nå den nye parameteren.

Bruke en datakildeparameter

  1. Gå til spørringen av en ny eller eksisterende flis.

  2. Velg navnet på den nye parameteren under Datakildeparametere i Kilde, for eksempel den nye kildeparameteren.

    Skjermbilde av å velge en datakildeparameter i spørringen.

  3. Velg Bruk endringer.

  4. Bruk kildeparameteren til å endre datakilden for denne tilkoblede spørringen.

Bruk filtersøk for enkeltutvalg og flervalgsfiltre

I enkeltvalg- og flervalgsfiltre, skriv inn verdien du ønsker. Filteret oppdateres til kun å vise verdier som matcher søkeordet.

Relatert innhold

  • Sist oppdatert