in

in évalue si une expression existe dans une liste littérale. Si la liste contient l'expression, in renvoie vrai, sinon il renvoie faux. in est sensible à la casse pour les entrées de type chaîne de caractères.

in accepte deux types de listes littérales : une liste saisie manuellement et un paramètre multivaleur.

Syntaxe

Utilisation d'une liste saisie manuellement :

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

Utilisation d'un paramètre multivaleur :

in(expression, $multivalue_parameter)

Arguments

expression

L'expression à comparer aux éléments de la liste littérale. Il peut s'agir d'un nom de champ comme address, d'une valeur littérale comme « Unknown », d'un paramètre à valeur unique ou d'un appel à une autre fonction scalaire, à condition que cette fonction ne soit pas une fonction d'agrégation ou un calcul de table.

liste littérale

(obligatoire) Il peut s'agir d'une liste saisie manuellement ou d'un paramètre multivaleur. Cet argument accepte jusqu'à 5 000 éléments. Toutefois, dans le cas d'une interrogation directe d'une source de données tierce, par exemple Oracle ou Teradata, la restriction peut être inférieure.

• liste saisie manuellement – Une ou plusieurs valeurs littérales dans une liste à comparer à l'expression. La liste doit être placée entre crochets. Toutes les valeurs littérales à comparer doivent avoir le même type de données que l'expression.

• paramètre multivaleur – Un paramètre multivaleur prédéfini transmis sous la forme d'une liste littérale. Le paramètre multivaleur doit avoir le même type de données que l'expression.

Type de retour

Valeur booléenne : TRUE/FALSE

Exemple avec une liste statique

L'exemple suivant évalue le champ origin_state_name pour les valeurs d'une liste de chaînes de caractères. Lors de la comparaison des entrées de type chaîne de caractères, in ne prend en charge que la comparaison sensible à la casse.

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

Les valeurs suivantes sont celles du champ donné.

"Washington"
        "ohio"
        "Texas"

Pour ces valeurs, les valeurs suivantes sont renvoyées.

false
        false
        true

La troisième valeur de retour est vraie car seul « Texas » fait partie des valeurs incluses.

L'exemple suivant évalue le champ fl_date pour les valeurs d'une liste de chaînes de caractères. Afin de faire correspondre le type, toString est utilisé pour convertir le type de date en type de chaîne.

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

Les valeurs littérales et les valeurs NULL sont prises en charge dans l'argument de l'expression pour être comparées aux valeurs littérales de la liste. Les deux exemples suivants génèrent une nouvelle colonne de valeurs VRAIES.

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

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

Exemple avec un paramètre mutivaleur

Supposons qu'un auteur crée un paramètre multivaleur contenant une liste de tous les noms d'état. Il ajoute ensuite un contrôle permettant au lecteur de sélectionner des valeurs dans la liste.

Ensuite, le lecteur sélectionne trois valeurs (« Georgia », « Ohio » et « Texas ») dans le contrôle de liste déroulante du paramètre. Dans ce cas, l'expression suivante est équivalente au premier exemple, où ces trois noms d'état sont transmis en tant que liste littérale à comparer avec le champ original_state_name.

in (origin_state_name, ${stateName MultivalueParameter})

Exemple avec ifelse

Le champ in peut être imbriqué dans d'autres fonctions en tant que valeur booléenne. Par exemple, les auteurs peuvent évaluer n'importe quelle expression dans une liste et renvoyer la valeur qu'ils veulent en utilisant in et ifelse. L'exemple suivant évalue si le dest_state_name d'un vol se trouve dans une liste particulière d'états américains et renvoie différentes catégories d'états sur la base de la comparaison.

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