Med parametere kan du be om verdier som skal brukes i filtrene eller beregningene i en spørring hver gang den kjøres. Ved å angi disse verdiene ved kjøring kan du bruke en spørring i en annen kontekst - for eksempel konto, region eller tidsperiode - hver gang den kjøres.
Du kan opprette egendefinerte parametere som skal brukes med en bestemt spørring, eller arbeidsområdeeieren kan opprette globale parametere som skal brukes med flere spørringer.
Opprette egendefinerte parametere for en spørring
Du kan angi parametere for en spørring i enten Builder eller SQL Editor. Når du oppretter en parameter, kan du bruke den med flere filtre og beregninger i spørringen.
Trinn 1. Opprett parameteren
- Klikk på Legg til på Parameters , og velg Opprett ny parameter.
<!-- -
From the Parameters
panel, click
Create Parameter.
--> - For å identifisere parameteren må du oppgi et unikt navn med kun alfanumeriske tegn og uten mellomrom.
- I Filtertype velger du hvilken type data du vil filtrere etter, for eksempel Tekst eller Heltall.
Trinn 2. Sett opp parameterverdiene
Når en spørring kjøres, kan parameterne akseptere frie verdier - basert på datatypen - eller gi en liste med spesifikke verdier å velge mellom.
- Hvis du vil godta en friformverdi, skriver du inn standardverdien (hvis aktuelt) og klikker på Create.
- For å gi en liste over spesifikke verdier:
- Aktiver Picklist.
- Hvis du vil aktivere flere verdier for parameteren, merker du av i boksen Multi-Select .
- I List Options skriver du inn verdiene du vil velge mellom, og trykker på Enter etter hver.
Merk: For en dato- eller tidsstempelparameter angir du hvert alternativ i formatet
ÅÅÅÅÅ-MM-dd. - Velg en standardverdi for parameteren, og klikk på Accept.
Merk: For en flervalgsparameter må du velge minst én standardverdi.
- Klikk på Create for å fullføre.
Trinn 3. Bruk parameteren i spørringen
Hvis du vil bruke parameterens verdi i spørringen, bruker du den i et filter eller en beregning:
- Hvis du vil angi verdien for et filter basert på parameteren i Builder, velger du den når du definerer filteret fra Filter Properties høyre panel.
Merk: For en flervalgsparameter, velg en filteroperator av Is In List eller Is Not In List på Filters -fanen.
- For å bruke parameteren med et filter i SQL Editor eller referere til verdien i en beregning, skriver du inn navnet etter et kolon (
:) i SQL-setningen, for eksempel:ReportingPeriod.
Bruk globale parametere i en spørring
Eieren av arbeidsområdet kan konfigurere globale parametere for felles verdier som brukes i flere spørringer. Slik bruker du globale parametere i en spørring:
- Fra Parameters klikker du på Add, og velger Select Global Parameter.
- Velg de globale parameterne som skal brukes i spørringen, og klikk på Add.
- Hvis du vil redigere den globale parameteren, velger du den og oppdaterer navnet eller verdien etter behov for spørringen.
Merk: For å sikre en konsekvent analyse kan eieren av arbeidsområdet låse en global parameter for å hindre at verdien redigeres.
-
Hvis du vil bruke en global parameters verdi i spørringen, bruker du den i et filter eller en beregning:
- Hvis du vil angi verdien for et filter basert på parameteren i Builder, velger du den når du definerer filteret fra Filter Properties høyre panel.
Merk: For en flervalgsparameter, velg en filteroperator av Is In List eller Is Not In List på Filters -fanen.
- For å referere til parameteren i SQL Editor skriver du inn navnet etter et kolon (
:) i SQL-setningen, for eksempel:ReportingPeriod. - For å referere til en parameterverdi i en SQL-setning i en beregning, velger du parameteren fra Parameters menyen.
- Hvis du vil angi verdien for et filter basert på parameteren i Builder, velger du den når du definerer filteret fra Filter Properties høyre panel.
Rediger en spørringsparameter
For å justere eller administrere detaljene i en parameter:
- Velg parameteren du vil redigere, fra Parameters.
- Rediger parameterens navn, datatype eller verdier etter behov.
- Klikk på Apply.
Fjerne en spørringsparameter
Hvis du ikke lenger trenger en parameter, kan du fjerne den fra spørringen. I Parameters klikker du på Delete , og deretter på Save .