Använda parametrar i Azure Data Explorer-instrumentpaneler

  • Artikel

Parametrar används som byggstenar för filter i Azure Data Explorer instrumentpaneler. De hanteras i instrumentpanelens omfång och kan läggas till i frågor för att filtrera de data som presenteras av det underliggande visuella objektet. En fråga kan använda en eller flera parametrar.

Det här dokumentet beskriver hur du skapar och använder parametrar och länkade filter i instrumentpaneler. Parametrar kan användas för att filtrera visuella instrumentpanelsobjekt antingen genom att välja parametervärden i filterfältet eller med hjälp av korsfilter.

Frågeexemplen som används i den här artikeln baseras på StormEvents tabellen i exempelgalleriet.

Anteckning

Parameterhantering är tillgängligt i redigeringsläge för instrumentpanelsredigerare.

Förutsättningar

Visa parameterlista

Om du vill visa listan över alla instrumentpanelsparametrar väljer du knappen Parametrar överst på instrumentpanelen.

Skärmbild av parameterknappen överst på instrumentpanelen.

Skapa en parameter

Så här skapar du en parameter:

  1. Växla från Visning till Redigeringsläge .

    Skärmbild av redigeringsknappen överst på instrumentpanelen.

  2. Välj knappen Parametrar överst på instrumentpanelen.

    Skärmbild av parameterknappen överst på instrumentpanelen.

  3. Välj knappen + Ny parameter längst upp i den högra rutan.

  4. Fyll i relevanta egenskaper för parametern.

Egenskaper som stöds

I fönstret Lägg till parameter konfigurerar du följande egenskaper:

Fält Beskrivning
Etikett Namnet på parametern som visas på instrumentpanelen eller redigeringskortet.
Parametertyp En av följande parametrar:
  • Enkel markering: Endast ett värde kan väljas i filtret som indata för parametern .
  • Flera val: Ett eller flera värden kan väljas i filtret som indata för parametern.
  • Tidsintervall: Gör att du kan skapa ytterligare parametrar för att filtrera frågor och instrumentpaneler baserat på tid. Varje instrumentpanel har en tidsintervallväljare som standard.
  • Fritext: Innehåller inga värden i filtret. Användaren kan skriva ett värde eller kopiera/klistra in ett värde i textfältet. Filtret behåller de senaste värdena som används.
Variabelnamn Namnet på parametern som ska användas i frågan. Tips: Om du prefixar variabelnamn med särskiljningsförmåga, till exempel ett understreck (_), blir det lättare att hitta dem när du skriver frågor.
Datatyp Datatypen för parametervärdena.
Visa på sidor Välj de sidor där den här parametern ska visas. Alternativet Välj alla visar parametern på alla sidor.
Källa Källan för parametervärdena:
  • Fasta värden: Introducerade statiska filtervärden manuellt.
  • Fråga: Dynamiskt introducerade värden med hjälp av en KQL-fråga.
Standardvärdet Standardvärdet för filtret. Filtret börjar alltid med standardvärdet vid första återgivningen av instrumentpanelen.
Lägg till värdet "Markera alla" Gäller endast för enskilda val och flera typer av urvalsparametrar. Används för att hämta data för alla parametervärden. Det här värdet bör vara inbyggt i frågan för att tillhandahålla funktionen. Fler exempel på hur du skapar sådana frågor finns i Använda den frågebaserade parametern med flera val.

Hantera parametrar

När du har valt Parametrar i det övre fältet kan du visa listan över befintliga parametrar. I varje parameterkort väljer du pennwidgeten för att redigera parametern eller väljer menyn Mer [...] till Duplicera, Ta bort eller flytta parametern.

Följande indikatorer kan visas på parameterkortet:

  • Visningsnamn för parameter
  • Variabelnamn
  • Antal frågor där parametern användes
  • Sidor som parametern är fäst på

Parameterkorten kan ordnas genom att dra och släppa eller genom att använda alternativet Flytta till > och välja den nya platsen.

Skärmbild av exempelparametrar.

Använda parametrar i frågan

En parameter måste användas i frågan för att göra filtret tillämpligt för det visuella frågeobjektet. När det har definierats kan du se parametrarna i frågesidans> filterstapel och i frågans intellisense.

Anteckning

Om parametern inte används i frågan förblir filtret inaktivt. När parametern har lagts till i frågan blir filtret aktivt.

Parametertyper

Flera typer av instrumentpanelsparametrar stöds enligt följande:

I följande exempel beskrivs hur du använder parametrar i en fråga för olika parametertyper.

Standardparameter för tidsintervall

Varje instrumentpanel har en tidsintervallparameter som standard. Det visas på instrumentpanelen som ett filter endast när det används i en fråga. Använd parameternyckelorden _startTime och _endTime för att använda standardparametern för tidsintervall i en fråga enligt följande exempel:

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

När tidsintervallfiltret har sparats visas det på instrumentpanelen. Nu kan den användas för att filtrera data på kortet. Du kan filtrera instrumentpanelen genom att välja från listrutan: Tidsintervall (senaste x minuter/timmar/dagar) eller ett anpassat tidsintervall.

Skärmbild som visar hur du filtrerar med anpassat tidsintervall.

Parametrar för fasta värden med enkel markering

Parametrar för fast värde baseras på fördefinierade värden som anges av användaren. I följande exempel visas hur du skapar en enskild markeringsparameter med fast värde.

Skapa en parameter med fasta värden för enstaka val

  1. Välj Parametrar för att öppna fönstret Parametrar och välj Ny parameter.

  2. Fyll i informationen på följande sätt:

    • Etikett: Händelsetyp

    • Parametertyp: Enkel markering

    • Variabelnamn: _eventType

    • Datatyp: Sträng

    • Fäst som instrumentpanelsfilter: markerat

    • Källa: Fasta värden

      I det här exemplet använder du följande värden:

      Värde Visningsnamn för parameter
      Åska vind Åska vind
      Hagel Hagel
      Flash Flood Blixtflod
      Torka Torka
      Vinterväder Vinterväder

    • Lägg till ett Välj alla-värde : Avmarkerat

    • Standardvärde: Åska vind

  3. Välj Klar för att skapa parametern .

Parametern visas i sidofönstret Parametrar , men används för närvarande inte i några visuella objekt.

Använda en parameter med fasta värden med en enda markering

  1. Kör en exempelfråga med den nya parametern Event TypTope med hjälp _eventType av variabelnamnet:

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

    Den nya parametern visas i parameterlistan överst på instrumentpanelen.

  2. Välj olika värden för att uppdatera de visuella objekten.

    Skärmbild som visar resultatet av de fem främsta tillstånden.

Parametrar för fasta värden med flera val

Parametrar för fast värde baseras på fördefinierade värden som anges av användaren. I följande exempel visas hur du skapar och använder en flervalsparameter med fast värde.

Skapa parametrar med fasta värden för flera val

  1. Välj Parametrar för att öppna fönstret Parametrar och välj Ny parameter.

  2. Fyll i informationen som anges i Använd en parameter med fasta värden med en enda markering med följande ändringar:

    • Etikett: Händelsetyp
    • Parametertyp: Flera val
    • Variabelnamn: _eventType

  3. Välj Klar för att skapa parametern .

De nya parametrarna kan visas i sidofönstret Parametrar , men används för närvarande inte i några visuella objekt.

Använda en parameter med fasta värden med flera val

  1. Kör en exempelfråga med den nya parametern Händelsetyp med hjälp av variabeln _eventType .

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

    Den nya parametern visas i parameterlistan överst på instrumentpanelen.

  2. Välj ett eller flera olika värden för att uppdatera de visuella objekten.

    Skärmbild som visar hur du väljer flera händelsetyper.

Frågebaserade parametrar med en markering

Frågebaserade parametervärden hämtas vid inläsning av instrumentpanelen genom att köra parameterfrågan. I följande exempel visas hur du skapar och använder en enskild urvalsfrågebaserad parameter.

Skapa en frågebaserad parameter med en enda markering

  1. Välj Parametrar för att öppna fönstret Parametrar och välj Ny parameter.

  2. Fyll i informationen som anges i Använd en parameter med fasta värden med en enda markering med följande ändringar:

    • Etikett: Tillstånd

    • Variabelnamn: _state

    • Källa: Fråga

    • Datakälla: StormEventsSample

    • Välj Redigera fråga och ange följande fråga. Välj Klar.

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

    • Värde: Tillstånd

    • Visningsnamn: Tillstånd

    • Standardvärde: Välj ett standardvärde

  3. Välj Klar för att skapa parametern .

Använda en frågebaserad parameter med en enda markering

  1. Följande exempelfråga med den nya state-parametern använder variabeln _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 nya parametern visas i parameterlistan överst på instrumentpanelen.

  2. Välj olika värden för att uppdatera de visuella objekten.

Frågebaserade parametrar med flera val

Frågebaserade parametervärden härleds vid inläsningen av instrumentpanelen genom att köra den användardefinierade frågan. I följande exempel visas hur du kan skapa en frågebaserad parameter med flera val:

Skapa en frågebaserad parameter med flera val

  1. Välj Parametrar för att öppna fönstret Parametrar och välj + Ny parameter.

    1. Fyll i informationen som anges i Använd en parameter med fasta värden med en enda markering med följande ändringar:
    • Etikett: Tillstånd
    • Parametertyp: Flera val
    • Variabelnamn: _state

  3. Välj Klar för att skapa parametern .

Använda en frågebaserad parameter med flera val

  1. Följande exempelfråga använder den nya state-parametern med hjälp av variabeln _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

    Anteckning

    I det här exemplet används alternativet Markera alla genom att söka efter tomma värden med isempty() funktionen .

    Den nya parametern visas i parameterlistan överst på instrumentpanelen.

  2. Välj ett eller flera olika värden för att uppdatera de visuella objekten.

Fritextparametrar

Fritextparametrar innehåller inga värden. De gör att du kan introducera ditt eget värde.

Skapa en fritextparameter

  1. Välj Parametrar för att öppna fönstret Parametrar och välj + Ny parameter.

  2. Fyll i informationen på följande sätt:

    • Etikett: Tillstånd
    • Parametertyp: Fritext
    • Variabelnamn: _state
    • Datatyp: Sträng
    • Standardvärde: Inget standardvärde

Använda en fritextparameter

  1. Kör en exempelfråga med den nya state-parametern med hjälp _state av variabelnamnet:

    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

Parametrar för datakälla

När du har lagt till datakällor på instrumentpanelen kan du skapa en parameter som väljer en eller flera av de tillgängliga datakällorna. Den här parametern kan användas i paneler och andra parametrar.

Skapa en datakällaparameter

  1. Välj Parametrar för att öppna fönstret Parametrar och välj + Ny parameter.

  2. Fyll i informationen på följande sätt:

    • Etikett: Källa
    • Parametertyp: Datakälla
    • Visa på sidor: Markera alla
    • Värden: Markera alla
    • Standardvärde: StormEventsSample

  3. Välj Klar.

Den nya parametern visas nu i parameterlistan överst på instrumentpanelen.

Använda en datakällaparameter

  1. Gå till frågan för en ny eller befintlig panel.

  2. I Källa väljer du namnet på den nya parametern under Parametrar för datakälla. För parametern ovan väljer du Kluster.

  3. Välj Tillämpa ändringar.

  4. Använd klusterparametern för att ändra datakällan för den här anslutna frågan.

Parametrar för korsfilter

Med korsfilter kan du välja ett värde i ett visuellt objekt och alla visuella instrumentpaneler, till exempel linje- eller punktdiagram, filtreras för att endast visa relaterade data. Genom att använda korsfilter får du samma resultat som att välja motsvarande värde för parametern i parameterlistan överst på instrumentpanelen.

Definiera korsfilter

Om du vill skapa ett korsfilter måste du aktivera alternativet i det visuella objektet och sedan ange den parameter som används för att filtrera data.

  1. Gå till frågan för panelen där du vill lägga till korsfilter.

  2. Välj Visuellt objekt.

  3. I den högra rutan väljer du Interaktioner och aktiverar sedan korsfilter.

  4. Du kan också ange interaktionstyp . Standardvärdet är Punkt där du kan välja ett värde i det visuella objektet. Om du vill välja ett värdeintervall, till exempel i ett tidsdiagram, väljer du Dra.

  5. Ange både kolumnen som används för att ange värdet och en parameter som används för att filtrera frågan.

    Viktigt

    Kolumnen och parametern måste ha samma datatyp.

Skärmbild av sidan Redigera visuellt objekt som visar fliken interaktioner.

Interagera med dina data med korsfilter

När korsfiltret har definierats kan du använda det för att interagera med dina data. I visuella objekt där du har definierat korsfilter kan du välja datapunkter och använda deras värden för att filtrera den aktuella instrumentpanelssidan. För visuella tabellobjekt väljer du datapunkter genom att högerklicka på den relevanta cellen och sedan välja Korsfilter i snabbmenyn.

Skärmbild av ett visuellt tabellobjekt som visar snabbmenyalternativet korsfilter.

Du kan återställa korsfiltret genom att välja Återställ överst i det visuella objekt där det har valts.

Skärmbild av ett visuellt tabellobjekt som visar återställningsknappen.

Använda drillthroughs som instrumentpanelsparametrar

Med detaljerad information kan du välja ett värde i ett visuellt objekt och använda det för att filtrera de visuella objekten på en målsida på samma instrumentpanel. När målsidan öppnas är värdet förvalt i relevanta filter. De visuella objekten på sidan, till exempel linje- eller punktdiagram, filtreras för att endast visa relaterade data.

Definiera en detaljerad information

Om du vill skapa en detaljerad information måste du först aktivera den i det visuella objektet och sedan lägga till en eller flera detaljerad information efter behov.

  1. Redigera det visuella objektet där du vill lägga till en detaljerad information. Kontrollera att fliken Visuellt objekt är markerad.

  2. I den högra rutan väljer du Interaktioner och aktiverar sedan visning av detaljerad information.

    Skärmbild av drillthrough-sidan som visar alternativet aktivera.

  3. Under Detaljerad information väljer du Skapa ny och anger följande information. Du kan också välja Lägg till ytterligare ett par för att lägga till flera parametrar för en målsida. Upprepa det här steget om du vill lägga till detaljerad information till andra sidor på den aktuella instrumentpanelen med hjälp av olika parametrar.

    Fält Beskrivning
    Målsida En eller flera målsidor att gå igenom med hjälp av de definierade parametrarna.
    Kolumn Frågeresultatets kolumn som ska användas som värde för en parameter på målsidan.
    Parameter Parametern som används för att filtrera visuella objekt på målsidan med hjälp av kolumnvärdet.
    Kommentarer Valfri kort beskrivning.

    Viktigt

    Kolumn- och parameterpar måste ha samma datatyp.

Interagera med dina data med hjälp av detaljerad information

När detaljerad information har definierats kan du använda dem för att interagera med dina data. Om du vill göra det högerklickar du på en datapunkt i visuella objekt eller tabeller där du har definierat en detaljerad information och väljer sedan Öka detaljnivån till>målsidan. Värdena från datapunkten används som parametrar för att filtrera de visuella objekten på målsidan.

Skärmbild av ett visuellt instrumentpanelsobjekt som visar interaktionen för visning av detaljerad information.

Gå tillbaka till källsidan genom att välja Återställ längst upp till höger på målsidan. Alla filter som tilldelats av drillthrough återställs.

Använda filtersökning för enkla och flera urvalsfilter

I enkla och flera markeringsfilter anger du önskat värde. Filtret uppdateras för att endast visa de värden som matchar söktermen.

Relaterat innehåll