in

in bewertet, ob ein Ausdruck in einer literalen Liste existiert. Wenn die Liste den Ausdruck enthält, wird wahr zurückgegeben, andernfalls falsch. in unterscheidet bei Eingaben vom Typ Zeichenfolge zwischen Groß- und Kleinschreibung.

in akzeptiert zwei Arten von literalen Listen: eine ist eine manuell eingegebene Liste und die andere ist ein mehrwertiger Parameter.

Syntax

Verwenden einer manuell eingegebenen Liste:

in(expression, [literal-1, ...])  

Verwendung eines mehrwertigen Parameters:

in(expression, $multivalue_parameter)

Argumente

expression

Der Ausdruck, der mit den Elementen in der literalen Liste verglichen werden soll. Dabei kann es sich um einen Feldnamen wie address, einen literalen Wert wie „Unknown„, einen Einzelwertparameter oder einen Aufruf einer anderen Skalarfunktion handeln — vorausgesetzt, es handelt sich bei dieser Funktion nicht um eine Aggregatfunktion oder eine Tabellenberechnung.

Literale Liste

(erforderlich) Dies kann eine manuell eingegebene Liste oder ein mehrwertiger Parameter sein. Dieses Argument akzeptiert bis zu 5.000 Elemente. Bei einer direkten Abfrage an eine Datenquelle eines Drittanbieters, beispielsweise Oracle oder Teradata, kann die Einschränkung jedoch geringer sein.

• manuell eingegebene Liste — Ein oder mehrere literale Werte in einer Liste, die mit dem Ausdruck verglichen werden sollen. Die Liste sollte in eckige Klammern gesetzt werden. Alle zu vergleichenden Literale müssen denselben Datentyp wie der Ausdruck haben.

• Mehrwertiger Parameter — Ein vordefinierter mehrwertiger Parameter, der als literale Liste übergeben wird. Der mehrwertige Parameter muss denselben Datentyp wie der Ausdruck haben.

Rückgabetyp

Boolescher Wert:/TRUEFALSE

Beispiel mit einer statischen Liste

Im folgenden Beispiel wird das Feld origin_state_name nach Werten in einer Zeichenfolgenliste ausgewertet. Beim Vergleich von Zeichenfolgeneingaben unterstützt in nur den Vergleich zwischen Groß- und Kleinschreibung.

in(origin_state_name,["Georgia", "Ohio", "Texas"])

Das Feld enthält folgende Werte.

"Washington"
        "ohio"
        "Texas"

Für diese Feldwerte werden die folgenden Ergebniswerte zurückgegeben.

false
        false
        true

Der dritte Rückgabewert ist true, da nur „Texas“ einer der eingeschlossenen Werte ist.

Im folgenden Beispiel wird das Feld fl_date nach Werten in einer Zeichenfolgenliste ausgewertet. Um dem Typ zu entsprechen, wird toString verwendet, um den Datumstyp in den Zeichenfolgentyp umzuwandeln.

in(toString(fl_date),["2015-05-14","2015-05-15","2015-05-16"])

Literale und NULL Werte werden im Ausdrucksargument unterstützt, um mit den Literalen in der Liste verglichen zu werden. In den beiden folgenden Beispielen wird eine neue Spalte mit Werten generiert. TRUE

in("Washington",["Washington","Ohio"])

in(NULL,[NULL,"Ohio"])

Beispiel mit mehrwertigem Parameter

Nehmen wir an, ein Autor erstellt einen mehrwertigen Parameter, der eine Liste aller Staatsnamen enthält. Dann fügt der Autor ein Steuerelement hinzu, mit dem der Leser Werte aus der Liste auswählen kann.

Als Nächstes wählt der Leser drei Werte - „Georgia“, „Ohio“ und „Texas“ - aus dem Dropdownlisten-Steuerelement des Parameters aus. In diesem Fall entspricht der folgende Ausdruck dem ersten Beispiel, in dem diese drei Bundesstaatennamen als literale Liste übergeben werden, die mit dem Feld original_state_name verglichen werden soll.

in (origin_state_name, ${stateName MultivalueParameter})

Beispiel mit ifelse

in kann als boolescher Wert in andere Funktionen verschachtelt werden. Ein Beispiel ist, dass Autoren jeden Ausdruck in einer Liste auswerten und den gewünschten Wert mithilfe von in und ifelse zurückgeben können. Im folgenden Beispiel wird ausgewertet, ob sich das dest_state_name eines Flug in einer bestimmten Liste von US-Bundesstaaten befindet, und es werden auf der Grundlage des Vergleichs verschiedene Kategorien der Bundesstaaten zurückgegeben.

ifelse(in(dest_state_name,["Washington", "Oregon","California"]), "WestCoastUSState", "Other US State")