Met parameters kunt u elke keer dat een query wordt uitgevoerd vragen om waarden die u wilt gebruiken in de filters of berekeningen van de query. Door deze waarden tijdens het uitvoeren in te stellen, kunt u een query telkens in een andere context gebruiken, zoals account, regio of tijdsperiode.
U kunt aangepaste parameters maken voor gebruik met een specifieke query, of uw workspace-eigenaar kan globale parameters maken voor gebruik met meerdere query's.
Aangepaste parameters voor een query maken
U kunt de parameters van een query instellen in Builder of SQL Editor. Wanneer u een parameter maakt, kunt u deze gebruiken met meerdere filters en berekeningen in de query.
Stap 1. Maak de parameter
- Klik in het paneel Parameters op Toevoegen en selecteer Nieuwe parameter maken.
<!-- -
From the Parameters
panel, click
Create Parameter.
--> - Om de parameter te helpen identificeren, voert u een unieke naam in met alleen alfanumerieke tekens en geen spaties.
- Selecteer in Filtertype het gegevenstype waarop u wilt filteren, zoals Tekst of Geheel getal.
Stap 2. De waarden van de parameter instellen
Wanneer een query wordt uitgevoerd, kunnen de parameters vrije waarden accepteren, gebaseerd op het gegevenstype, of een lijst met specifieke waarden geven waaruit u kunt kiezen.
- Om een willekeurige vrije waarde te accepteren, voert u de standaardwaarde in (indien van toepassing) en klikt u op Maak.
- Een lijst met specifieke waarden geven:
- Picklist inschakelen.
- Schakel het selectievakje Multi-Select in om meerdere waarden voor de parameter in te schakelen.
- Voer in Lijstopties de waarden in waaruit u kunt kiezen en druk na elke waarde op Enter.
Opmerking: Voor een datum- of tijdstempelparameter voert u elke optie in het formaat
YYYY-MM-ddin. - Selecteer een willekeurige standaardwaarde voor de parameter en klik op Accepteren.
Opmerking: Selecteer voor een multi-select parameter ten minste één standaardwaarde.
- Klik op Create om te voltooien.
Stap 3. Gebruik de parameter in de query
Om de waarde van de parameter toe te passen op de query, gebruikt u deze in een filter of berekening:
- Om de waarde van een filter in te stellen op basis van de parameter in Builder, selecteert u deze wanneer u het filter definieert in het paneel Filtereigenschappen rechts.
Opmerking: Voor een multi-select parameter, selecteer een filteroperator van Is in lijst of Is niet in lijst op het tabblad Filters.
- Om de parameter te gebruiken met een filter in SQL Editor of naar de waarde ervan te verwijzen in een berekening, voert u de naam ervan in na een dubbele punt (
:) in de SQL-instructie, zoals:ReportingPeriod.
Globale parameters in een query gebruiken
Uw workspace-eigenaar kan globale parameters configureren voor gemeenschappelijke waarden die bij meerdere query's worden gebruikt. Om globale parameters in een query te gebruiken:
- Klik in het paneel Parameters op Toevoegen en selecteer Selecteer Globale parameter.
- Selecteer de globale parameters die u in de query wilt gebruiken en klik op Toevoegen.
- Om de globale parameter te bewerken, selecteert u deze en werkt u de naam of waarde ervan bij zoals nodig voor de query.
Opmerking: Om een consistente analyse te garanderen, kan de eigenaar van uw werkruimte een globale parameter vergrendelen om te voorkomen dat de waarde ervan wordt bewerkt.
-
Om de waarde van een globale parameter toe te passen op de query, gebruikt u deze in een filter of berekening:
- Om de waarde van een filter in te stellen op basis van de parameter in Builder, selecteert u deze wanneer u het filter definieert in het paneel Filtereigenschappen rechts.
Opmerking: Voor een multi-select parameter, selecteer een filteroperator van Is in lijst of Is niet in lijst op het tabblad Filters.
- Om in SQL Editor naar de parameter te verwijzen, voert u de naam in na een dubbele punt (
:) in de SQL-instructie, zoals:ReportingPeriod. - Om te verwijzen naar een parameterwaarde in een SQL-instructie van een berekening, selecteert u de parameter in het menu Parameters.
- Om de waarde van een filter in te stellen op basis van de parameter in Builder, selecteert u deze wanneer u het filter definieert in het paneel Filtereigenschappen rechts.
Een queryparameter bewerken
De details van een parameter aanpassen of beheren:
- Selecteer in het paneel Parameters de parameter die u wilt bewerken.
- Bewerk waar nodig de naam, het gegevenstype of de waarden van de parameter.
- Klik op Toepassen.
Een queryparameter verwijderen
Als u een parameter niet langer nodig hebt, kunt u deze uit de query verwijderen. Klik in het paneel Parameters op Verwijder van de parameter en klik op Opslaan .