Queryparameters beheren

Met parameters kun je vragen om waarden om te gebruiken met de filters of berekeningen van een query telkens als deze wordt uitgevoerd. Door deze waarden tijdens het uitvoeren in te stellen, kun je een query telkens in een andere context gebruiken, zoals account, regio of tijdsperiode.

Je kunt aangepaste parameters maken voor gebruik met een specifieke query, of je workspace-eigenaar kan globale parameters maken voor gebruik met meerdere queries.

Aangepaste parameters voor een query maken

Je kunt de parameters van een query instellen in Builder of SQL Editor. Wanneer je een parameter maakt, kun je deze gebruiken met meerdere filters en berekeningen in de query. 

Stap 1. Maak de parameter

1. Klik in het paneel Parameters op Toevoegen en selecteer Nieuwe parameter maken.
   
2. Voer een unieke naam in met alleen alfanumerieke tekens en geen spaties om de parameter te helpen identificeren.
3. Selecteer in Filtertype het gegevenstype waarop u wilt filteren, zoals Tekst of Integer.

Stap 2. Stel de parameterwaarden in

Wanneer een query wordt uitgevoerd, kunnen de parameters vrije waarden accepteren op basis van het gegevenstype of een lijst met specifieke waarden geven waaruit gekozen kan worden. 

• Als u een vrije waarde wilt accepteren, voert u de standaardwaarde in (indien van toepassing) en klikt u op Maak.
• Een lijst met specifieke waarden geven:

1. Picklist inschakelen.
2. Schakel het selectievakje Multi-Select in om meerdere waarden voor de parameter in te schakelen.
3. Voer in Lijstopties de waarden in waaruit u kunt kiezen en druk na elke waarde op Enter.

   Opmerking: Voer voor een datum- of tijdstempelparameter elke optie in de indeling JJJJ-MM-dd in.

4. Selecteer een standaardwaarde voor de parameter en klik op Accepteer.

   Opmerking: Voor een multi-select parameter, selecteer ten minste één standaardwaarde.

5. Klik op maken om te voltooien.

Stap 3. Gebruik de parameter in de query

Om de waarde van de parameter toe te passen op de query, gebruik je deze in een filter of berekening:

• Om de waarde van een filter in te stellen op basis van de parameter in Builder, selecteer je deze wanneer je het filter definieert in het rechterpaneel met filtereigenschappen.

  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.

1. Klik in het paneel Parameters op Toevoegen en selecteer Selecteer Globale parameter.
   
2. Selecteer de globale parameters die u in de query wilt gebruiken en klik op Toevoegen.
3. Om de globale parameter te bewerken, selecteer je deze en pas je de naam of waarde aan zoals nodig voor de query.

   Opmerking: Om een consistente analyse te garanderen, kan de eigenaar van de werkruimte een globale parameter vergrendelen om te voorkomen dat de waarde ervan wordt bewerkt.

4. Om de waarde van een globale parameter toe te passen op de query, gebruik je deze in een filter of berekening:

   • Om de waarde van een filter in te stellen op basis van de parameter in Builder, selecteer je deze wanneer je het filter definieert in het rechterpaneel met filtereigenschappen.

     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, voer je 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.