Mit Parametern können Sie bei jeder Ausführung einer Abfrage nach Werten fragen, die mit den Filtern oder Berechnungen der Abfrage verwendet werden sollen. Wenn Sie diese Werte zur Laufzeit festlegen, können Sie eine Abfrage bei jeder Ausführung in einem anderen Kontext verwenden, z. B. für ein Konto, eine Region oder einen Zeitraum.
Sie können benutzerdefinierte Parameter zur Verwendung mit einer bestimmten Abfrage erstellen, oder Ihr Arbeitsbereichseigentümer kann globale Parameter zur Verwendung mit mehreren Abfragen erstellen.
Benutzerdefinierte Parameter für eine Abfrage erstellen
Sie können die Parameter einer Abfrage entweder im Builder oder im SQL Editor festlegen. Wenn Sie einen Parameter erstellen, können Sie ihn mit mehreren Filtern und Berechnungen in der Abfrage verwenden.
Schritt 1. Erstellen Sie den Parameter
- Klicken Sie im Bereich Parameter auf Hinzufügen, und wählen Sie Neuen Parameter erstellen.
<!-- -
From the Parameters
panel, click
Create Parameter.
--> - Um den Parameter zu identifizieren, geben Sie einen eindeutigen Namen ein, der nur alphanumerische Zeichen enthält und keine Leerzeichen .
- Wählen Sie unter Filtertypden Datentyp aus, nach dem gefiltert werden soll, z. B. Text oder Integer.
Schritt 2. Legen Sie die Werte der Parameter fest
Wenn eine Abfrage ausgeführt wird, können ihre Parameter freie Werte akzeptieren, die auf dem Datentyp basieren, oder eine Liste bestimmter Werte zur Auswahl bereitstellen.
- Um einen beliebigen Freiformwert zu akzeptieren, geben Sie den Standardwert ein (falls zutreffend), und klicken Sie auf Erstellen.
- Um eine Liste von spezifischen Werten zu erstellen:
- Aktivieren Sie Auswahlliste.
- Um mehrere Werte für den Parameter zu aktivieren, markieren Sie das Feld Multi-Select .
- Geben Sie unter List Optionsdie gewünschten Werte ein und drücken Sie nach jedem Wert Enter .
Hinweis: Für einen Datums- oder Zeitstempelparameter geben Sie jede Option im Format
JJJJ-MM-tt
ein. - Wählen Sie einen beliebigen Standardwert für den Parameter aus, und klicken Sie auf Akzeptieren.
Hinweis: Für einen Mehrfachauswahlparameter muss mindestens ein Standardwert ausgewählt werden.
- Klicken Sie zum Abschluss auf .
Schritt 3. Verwenden Sie den Parameter in der Abfrage
Um den Wert des Parameters auf die Abfrage anzuwenden, verwenden Sie ihn in einem Filter oder einer Berechnung:
- Um den Wert eines Filters auf der Grundlage des Parameters in Builder festzulegen, wählen Sie ihn bei der Definition des Filters im rechten Bereich Filter Properties aus.
Hinweis: Für einen Parameter mit Mehrfachauswahl , wählen Sie einen Filteroperator von Ist in Liste oder Ist nicht in Liste auf der Registerkarte Filter .
- Um den Parameter mit einem Filter im SQL-Editor zu verwenden oder seinen Wert in einer Berechnungzu referenzieren, geben Sie seinen Namen nach einem Doppelpunkt (
:
) in der SQL-Anweisung ein, z. B.:ReportingPeriod
.
Globale Parameter in einer Abfrage verwenden
Ihr Arbeitsbereichseigentümer kann globale Parameter für gemeinsame Werte konfigurieren, die bei mehreren Abfragen verwendet werden. Um globale Parameter in einer Abfrage zu verwenden:
- Klicken Sie im Bereich Parameter auf Hinzufügen, und wählen Sie Globale Parameter auswählen.
- Wählen Sie die globalen Parameter aus, die in der Abfrage verwendet werden sollen, und klicken Sie auf Add.
- Um den globalen Parameter zu bearbeiten, wählen Sie ihn aus und aktualisieren Sie seinen Namen oder Wert nach Bedarf für die Abfrage.
Hinweis: Um eine konsistente Analyse zu gewährleisten, kann Ihr Arbeitsbereichseigentümer einen globalen Parameter sperren, um zu verhindern, dass sein Wert bearbeitet wird.
-
Um den Wert eines globalen Parameters auf die Abfrage anzuwenden, verwenden Sie ihn in einem Filter oder einer Berechnung:
- Um den Wert eines Filters auf der Grundlage des Parameters in Builder festzulegen, wählen Sie ihn bei der Definition des Filters im rechten Bereich Filter Properties aus.
Hinweis: Für einen Parameter mit Mehrfachauswahl , wählen Sie einen Filteroperator von Ist in Liste oder Ist nicht in Liste auf der Registerkarte Filter .
- Um den Parameter im SQL-Editor zu referenzieren, geben Sie seinen Namen nach einem Doppelpunkt (
:
) in die SQL-Anweisung ein, z. B.:ReportingPeriod
. - Um einen Parameterwert in der SQL-Anweisung einer Berechnungzu referenzieren, wählen Sie den Parameter im Menü Parameter aus.
- Um den Wert eines Filters auf der Grundlage des Parameters in Builder festzulegen, wählen Sie ihn bei der Definition des Filters im rechten Bereich Filter Properties aus.
Einen Abfrageparameter bearbeiten
Zum Einstellen oder Verwalten der Details eines Parameters:
- Wählen Sie im Bereich Parameter den zu bearbeitenden Parameter aus.
- Bearbeiten Sie bei Bedarf den Namen, den Datentyp oder die Werte des Parameters.
- Klicken Sie auf Übernehmen.
Einen Abfrageparameter entfernen
Wenn Sie einen Parameter nicht mehr benötigen, können Sie ihn aus der Abfrage entfernen. Klicken Sie im Bereich Parameter auf den Parameter Löschen , und klicken Sie auf Speichern .