Fonctions de mappage de Data Prep

Les fonctions de préparation de données peuvent être utilisées pour calculer et calculer des valeurs en fonction de ce qui est entré dans les champs source.

Champs

Un nom de champ peut être n’importe quel identificateur légal : une séquence illimitée de lettres et de chiffres Unicode, commençant par une lettre, le signe dollar ($), ou le caractère de soulignement (_). Les noms de variables sont également sensibles à la casse.

Si un nom de champ ne suit pas cette convention, le nom de champ doit être enveloppé avec ${}. Par exemple, si le nom du champ est "Prénom" ou "Prénom.Nom", le nom doit être enveloppé comme ${First Name} ou ${First.Name} respectivement.

En outre, si un nom de champ est quelconque parmi les mots-clés réservés suivants, il doit être entouré de ${}:

new, mod, or, break, var, lt, for, false, while, eq, gt, div, not, null, continue, else, and, ne, true, le, if, ge, return

Les données des sous-champs sont accessibles à l’aide de la notation par point. Par exemple, s’il y avait un name pour accéder à l’objet firstName champ, utiliser name.firstName.

Liste des fonctions

Les tableaux suivants répertorient toutes les fonctions de mappage prises en charge, y compris les exemples d’expressions et leurs sorties résultantes.

Fonctions de chaîne

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
concat Concatène les chaînes données.
  • CHAÎNE : Les chaînes qui seront concaténées.
concat(STRING_1, STRING_2) concat("Hi, ", "there", "!") "Hi, there!"
explode Divise la chaîne sur base d’un regex et renvoie un tableau de parties. Peut éventuellement inclure regex pour fractionner la chaîne. Par défaut, la division prend la valeur ",". Délimiteurs suivants besoin à échapper par \: `+, ?, ^, , ., [, (, {, ), *, $, ` Si vous incluez plusieurs caractères comme délimiteur, le délimiteur sera traité comme délimiteur à plusieurs caractères.
  • CHAÎNE : Obligatoire Chaîne à fractionner.
  • REGEX : Facultatif Expression régulière pouvant être utilisée pour fractionner la chaîne.
explode(STRING, REGEX) explode("Hi, there!", " ")
instr Renvoie l’emplacement/l’index d’une sous-chaîne.
  • ENTRÉE : Obligatoire Chaîne en cours de recherche.
  • SOUS-CHAÎNE : Obligatoire La sous-chaîne recherchée dans la chaîne.
  • START_POSITION : Facultatif Emplacement où commencer à chercher dans la chaîne.
  • OCCURRENCE : Facultatif La neuvième occurrence à rechercher à partir de la position de départ. Par défaut, elle est définie sur 1.
(INPUT, SUBSTRING, START_POSITION, OCCURRENCE) ("adobe.com", "com") 6
replacestr Remplace la chaîne de recherche si elle est présente dans la chaîne d’origine.
  • ENTRÉE : Obligatoire Chaîne d’entrée.
  • TO_FIND : Obligatoire Chaîne à rechercher dans l’entrée.
  • TO_REPLACE : Obligatoire Chaîne qui remplacera la valeur dans "TO_FIND".
replacestr(INPUT, TO_FIND, TO_REPLACE) replacestr("This is a string re test", "re", "replace") "This is a string replace test"
substr Renvoie une sous-chaîne d’une longueur donnée.
  • ENTRÉE : Obligatoire Chaîne d’entrée.
  • START_INDEX : Obligatoire Index de la chaîne d'entrée où commence la sous-chaîne.
  • LONGUEUR : Obligatoire Longueur de la sous-chaîne.
◘(INPUT, START_INDEX, LENGTH) substr("This is a substring test", 7, 8) " a subst"
lower /
lcase
Convertit une chaîne en minuscules.
  • ENTRÉE : Obligatoire Chaîne qui sera convertie en minuscules.
lower(INPUT) lower("HeLLo")
lcase("HeLLo")
"hello"
upper /
ucase
Convertit une chaîne en majuscules.
  • ENTRÉE : Obligatoire Chaîne qui sera convertie en majuscules.
high(INPUT) upper("HeLLo")
ucase("HeLLo")
"HELLO"
split Divise une chaîne d’entrée sur un séparateur. Le séparateur suivant besoins à échapper par \: \. Si vous incluez plusieurs délimiteurs, la chaîne sera scindée sur quelconque des délimiteurs présents dans la chaîne.
  • ENTRÉE : Obligatoire Chaîne d'entrée qui va être fractionnée.
  • SÉPARATEUR : Obligatoire Chaîne utilisée pour fractionner l’entrée.
split (ENTRÉE, SÉPARATEUR) split("Hello world", " ") ["Hello", "world"]
join Joint une liste d’objets à l’aide du séparateur.
  • SÉPARATEUR : Obligatoire Chaîne qui sera utilisée pour joindre les objets.
  • OBJETS : Obligatoire Tableau de chaînes qui seront jointes.
join(SEPARATOR, [OBJECTS]) join(" ", to_array(true, "Hello", "world")) "Hello world"
lpad Fait glisser le côté gauche d’une chaîne avec l’autre chaîne donnée.
  • ENTRÉE : Obligatoire La chaîne qui va être ajoutée. Cette chaîne peut être null.
  • COMPTE : Obligatoire Taille de la chaîne à ajouter.
  • PADDING : Obligatoire Chaîne avec laquelle ajouter l’entrée. Si elle est nulle ou vide, elle sera traitée comme un espace unique.
lpad(INPUT, COUNT, PADDING) lpad("bat", 8, "yz") "yzyzybat"
rpad Applique le côté droit d’une chaîne à l’autre chaîne donnée.
  • ENTRÉE : Obligatoire La chaîne qui va être ajoutée. Cette chaîne peut être null.
  • COMPTE : Obligatoire Taille de la chaîne à ajouter.
  • PADDING : Obligatoire Chaîne avec laquelle ajouter l’entrée. Si elle est nulle ou vide, elle sera traitée comme un espace unique.
rpad(ENTRÉE, COMPTE, PADDING) rpad("bat", 8, "yz") "batyzyzy"
left Obtient les premiers caractères "n" de la chaîne donnée.
  • CHAÎNE : Obligatoire Chaîne pour laquelle vous obtenez les premiers caractères "n".
  • COMPTE : Obligatoire Les caractères "n" que vous voulez obtenir de la chaîne.
left(STRING, COUNT) left("abcde", 2) "ab"
droit Obtient les derniers caractères "n" de la chaîne donnée.
  • CHAÎNE : Obligatoire Chaîne pour laquelle vous obtenez les derniers caractères "n".
  • COMPTE : Obligatoire Les caractères "n" que vous voulez obtenir de la chaîne.
right(STRING, COUNT) right("abcde", 2) "de"
ltrim Supprime l’espace blanc du début de la chaîne.
  • CHAÎNE : Obligatoire Chaîne dont vous souhaitez supprimer l’espace blanc.
ltrim(STRING) ltrim(" hello") "bonjour"
rtrim Supprime l’espace blanc de la fin de la chaîne.
  • CHAÎNE : Obligatoire Chaîne dont vous souhaitez supprimer l’espace blanc.
rtrim(STRING) rtrim("hello") "bonjour"
trim Supprime l’espace blanc du début et de la fin de la chaîne.
  • CHAÎNE : Obligatoire Chaîne dont vous souhaitez supprimer l’espace blanc.
trim(STRING) trim(" bonjour ") "bonjour"
est égal à Compare deux chaînes pour vérifier si elles sont égales. Cette fonction respecte la casse.
  • STRING1 : Obligatoire La première chaîne à comparer.
  • STRING2 : Obligatoire La deuxième chaîne à comparer.
STRING1. ​equals( ​ STRING2) "string1". ​est égal à ​("STRING1") false
equalsIgnoreCase Compare deux chaînes pour vérifier si elles sont égales. Cette fonction est non sensible à la casse.
  • STRING1 : Obligatoire La première chaîne à comparer.
  • STRING2 : Obligatoire La deuxième chaîne à comparer.
STRING1. ​equalsIgnoreCase ​(STRING2) "string1". ​equalsIgnoreCase ​("STRING1") vrai

Fonctions d’expressions régulières

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
extract_regex Extrait les groupes de la chaîne d’entrée, en fonction d’une expression régulière.
  • CHAÎNE : Obligatoire Chaîne à partir de laquelle vous extrayez les groupes.
  • REGEX : Obligatoire L’expression régulière à laquelle le groupe doit correspondre.
extract_regex(STRING, REGEX) extract_regex ​("E259,E259B_009,1_1" ​, "([,]+),[,]*,([^,]+)") ["E259,E259B_009,1_1", "E259", "1_1"]
match_regex Vérifie si la chaîne correspond à l’expression régulière saisie.
  • CHAÎNE : Obligatoire La chaîne que vous vérifiez correspond à l’expression régulière.
  • REGEX : Obligatoire Expression régulière par rapport à laquelle vous comparez.
match_regex(STRING, REGEX) match_regex("E259,E259B_009,1_1", "([,]+),[,]*,([^,]+)") vrai

Fonctions de hachage

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
sha1 Prend une entrée et produit une valeur de hachage à l’aide de l’algorithme de hachage sécurisé 1 (SHA-1).
  • ENTRÉE : Obligatoire Texte brut à hacher.
  • CHARSET : Facultatif Nom du jeu de caractères. Les valeurs possibles sont UTF-8, UTF-16, ISO-8859-1 et US-ASCII.
sha1(INPUT, CHARSET) sha1("my text", "UTF-8") c3599c11e47719df18a24 ​ 48690840c5dfcce3c80
sha256 Prend une entrée et produit une valeur de hachage à l’aide de l’algorithme de hachage sécurisé 256 (SHA-256).
  • ENTRÉE : Obligatoire Texte brut à hacher.
  • CHARSET : Facultatif Nom du jeu de caractères. Les valeurs possibles sont UTF-8, UTF-16, ISO-8859-1 et US-ASCII.
sha256(ENTRÉE, CHARSET) sha256("my text", "UTF-8") 7330d2b39ca35eaf4cb95fc846c21 ​ ee6a39af698154a83a586ee270a0d372104
sha512 Prend une entrée et produit une valeur de hachage à l’aide de l’algorithme de hachage sécurisé 512 (SHA-512).
  • ENTRÉE : Obligatoire Texte brut à hacher.
  • CHARSET : Facultatif Nom du jeu de caractères. Les valeurs possibles sont UTF-8, UTF-16, ISO-8859-1 et US-ASCII.
sha512(ENTRÉE, CHARSET) sha512("my text", "UTF-8") a3d7e45a0d9be5fd4e4b9a3b8c9c2163c21ef ​ 708bf11b4232bb21d2a8704ada2cdcd7b367dd00 788a89 ​ a5c908cfe377aceb1072a7b386b7d4fd2ff68a8fd24d16
md5 Prend une entrée et produit une valeur de hachage à l’aide de MD5.
  • ENTRÉE : Obligatoire Texte brut à hacher.
  • CHARSET : Facultatif Nom du jeu de caractères. Les valeurs possibles sont UTF-8, UTF-16, ISO-8859-1 et US-ASCII.
md5(INPUT, CHARSET) md5("my text", "UTF-8") d3b96ce8c9fb4 ​ e9bd0198d03ba6852c7
crc32 Prend une entrée utilise un algorithme de contrôle de redondance cyclique (CRC) pour produire un code cyclique 32 bits.
  • ENTRÉE : Obligatoire Texte brut à hacher.
  • CHARSET : Facultatif Nom du jeu de caractères. Les valeurs possibles sont UTF-8, UTF-16, ISO-8859-1 et US-ASCII.
crc32(ENTRÉE, CHARSET) crc32("my text", "UTF-8") 8df92e80

Fonctions URL

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
get_url_protocol Renvoie le protocole à partir de l'URL donnée. Si l’entrée n’est pas valide, elle renvoie la valeur Null.
  • URL : Obligatoire URL à partir de laquelle le protocole doit être extrait.
get_url_protocol ​(URL) get_url_protocol("https://platform ​ .adobe.com/home") https
get_url_host Renvoie l'hôte de l'URL donnée. Si l’entrée n’est pas valide, elle renvoie la valeur Null.
  • URL : Obligatoire URL à partir de laquelle l'hôte doit être extrait.
get_url_host ​(URL) get_url_host ​("https://platform ​ .adobe.com/home") platform.adobe.com
get_url_port Renvoie le port de l'URL donnée. Si l’entrée n’est pas valide, elle renvoie la valeur Null.
  • URL : Obligatoire URL à partir de laquelle le port doit être extrait.
get_url_port(URL) get_url_port ​("sftp://example.com//home/ ​ joe/employee.csv") 22
get_url_path Renvoie le chemin d’accès de l’URL donnée. Par défaut, le chemin d’accès complet est renvoyé.
  • URL : Obligatoire URL à partir de laquelle le chemin d’accès doit être extrait.
  • FULL_PATH : Facultatif Valeur booléenne qui détermine si le chemin complet est renvoyé. Si la valeur est false, seule la fin du tracé est renvoyée.
get_url_path ​(URL, FULL_PATH) get_url_path ​("sftp://example.com// ​ home/joe/employee.csv") "//home/joe/ ​ employee.csv"
get_url_query_str Renvoie la chaîne de requête d'une URL donnée.
  • URL : Obligatoire URL à partir de laquelle vous tentez d'obtenir la chaîne de requête.
  • ANCRAGE : Obligatoire Détermine ce qui sera fait avec l'ancre dans la chaîne de requête. Il peut s’agir de l’une des trois valeurs suivantes : "preserve", "remove" ou "append".

    Si la valeur est "conserver", l’ancre est attachée à la valeur renvoyée.
    Si la valeur est "remove", l’ancrage sera supprimé de la valeur renvoyée.
    Si la valeur est "append", l’ancre est renvoyée sous la forme d’une valeur distincte.
get_url_query_str ​(URL, ANCHOR) get_url_query_str ​("foo://example.com:8042 ​/over/here?name= ​ furet#nose", "preserve")
get_url_query_str ​("foo://example.com:8042 ​/over/here?name= ​ furet#nose", "remove")
get_url_query_str ​("foo://example.com ​:8042/over/here/here ​?name=furet#nose", "append")
{"name": "ferret#nose"}
{"name": "ferret"}
{"name": "ferret", "_anchor_": "nose"}

Fonctions de date et d’heure

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau. Plus d’informations sur la date se trouve dans la section dates du guide de gestion des formats de données.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
now Récupère l’heure actuelle. now() now() 2020-09-23T10:10:24.556-07:00[America/Los_Angeles]
timestamp Récupère l’heure Unix actuelle. timestamp() timestamp() 1571850624571
format Formate la date d’entrée selon un format spécifié.
  • DATE : Obligatoire La date d'entrée, en tant qu'objet ZonedDateTime, que vous souhaitez mettre en forme.
  • FORMAT : Obligatoire Format dans lequel vous souhaitez modifier la date.
format(DATE, FORMAT) format(2019-10-23T11:24:00+00:00, "aaaa-MM-jj HH:mm:ss") "2019-10-23 11:24:35 pouces
dformat Convertit une date et une heure en chaîne de date selon un format spécifié.
  • TIMESTAMP : Obligatoire L’horodatage à formater. Ceci est écrit en millisecondes.
  • FORMAT : Obligatoire Format que vous souhaitez que l’horodatage devienne.
dformat ​(TIMESTAMP, FORMAT) dformat(1571829875000, "yyy-MM-dd'T'HH:mm:ss.SSSX") "2019-10-23T11:24:35,000Z"
date Convertit une chaîne de date en objet ZonedDateTime (format ISO 8601).
  • DATE : Obligatoire Chaîne représentant la date.
  • FORMAT : Obligatoire Chaîne représentant le format de la date source.Remarque : Cette opération non représente le format dans lequel vous souhaitez convertir la chaîne de date.
  • DEFAULT_DATE : Obligatoire La date par défaut renvoyée, si la date fournie est nulle.
date(DATE, FORMAT, DEFAULT_DATE) date("2019-10-23 11:24", "aaaa-MM-jj HH:mm", now())) "2019-10-23T11:24Z"
date Convertit une chaîne de date en objet ZonedDateTime (format ISO 8601).
  • DATE : Obligatoire Chaîne représentant la date.
  • FORMAT : Obligatoire Chaîne représentant le format de la date source.Remarque : Cette opération non représente le format dans lequel vous souhaitez convertir la chaîne de date.
date(DATE, FORMAT) date("2019-10-23 11:24", "aaaa-MM-jj HH:mm") "2019-10-23T11:24Z"
date Convertit une chaîne de date en objet ZonedDateTime (format ISO 8601).
  • DATE : Obligatoire Chaîne représentant la date.
date(DATE) date("2019-10-23 11:24") "2019-10-23T11:24Z"
date_part Récupère les parties de la date. Les valeurs de composant suivantes sont prises en charge :

"year"
"yyyy"
"yy"

"quarter"
"qq"
"q"

"month"
"mm"
"m"

"dayofyear"
"dy"
"y"

"day"
"dd"
"d"

"week"
"ww"
"w"

"weekday"
"dw"
"w"

"hour"
"hh"
"hh24"
"hh12"

"minute"
"mi"
"n"

"second"
"ss"
"s"

"millisecond"
"ms"
  • COMPOSANT : Obligatoire Chaîne représentant la partie de la date.
  • DATE : Obligatoire La date, dans un format standard.
date_part ​(COMPONENT, DATE) date_part("MM", date("2019-10-17 11:55:12 pouces)) 10
set_date_part Remplace un composant à une date donnée. Les composants suivants sont acceptés :

"year"
"yyyy"
"yy"

"month"
"mm"
"m"

"day"
"dd"
"d"

"hour"
"hh"

"minute"
"mi"
"n"

"second"
"ss"
"s"
  • COMPOSANT : Obligatoire Chaîne représentant la partie de la date.
  • VALEUR : Obligatoire Valeur à définir pour le composant pour une date donnée.
  • DATE : Obligatoire La date, dans un format standard.
set_date_part ​(COMPOSANT, VALEUR, DATE) set_date_part("m", 4, date("2016-11-09T11:44:44,797") "2016-04-09T11:44:44,797 po
make_date_time Crée une date à partir de parties. Cette fonction peut également être induite à l'aide de make_timestamp.
  • ANNÉE : Obligatoire L'année, écrite en quatre chiffres.
  • MOIS : Obligatoire Le mois. Les valeurs autorisées sont comprises entre 1 et 12.
  • JOUR : Obligatoire Le jour. Les valeurs autorisées sont comprises entre 1 et 31.
  • HEURE : Obligatoire L'heure. Les valeurs autorisées sont comprises entre 0 et 23.
  • MINUTE : Obligatoire La minute. Les valeurs autorisées sont comprises entre 0 et 59.
  • NANOSECOND : Obligatoire Valeurs de nanoseconde. Les valeurs autorisées sont comprises entre 0 et 9999999999.
  • TIMEZONE : Obligatoire Fuseau horaire pour l’heure de la date.
make_date_time ​(ANNÉE, MOIS, JOUR, HEURE, MINUTE, SECONDE, NANOSECOND, TIMEZONE) make_date_time ​(2019, 10, 17, 11, 55, 12, 999, "America/Los_Angeles") 2019-10-17T11:55:12.0​00000999-07:00[America/Los_Angeles]
zone_date_to_utc Convertit une date dans n'importe quel fuseau horaire en date UTC.
  • DATE : Obligatoire La date que vous tentez de convertir.
zone_date_to_utc ​(DATE) zone_date_to_utc​(2019-10-17T11:55:​12.000000999-​07:00[America/Los_Angeles]) 2019-10-17T18:55:12.000000999Z[UTC]
zone_date_to_zone Convertit une date d’un fuseau horaire en un autre fuseau horaire.
  • DATE : Obligatoire La date que vous tentez de convertir.
  • ZONE : Obligatoire Fuseau horaire vers lequel vous tentez de convertir la date.
zone_date_to_zone ​(DATE, ZONE) zone_date_to_utc​(2019-10-17T11:55:12​.000000999-07:00​[America/Los_Angeles], "Europe/Paris") 2019-10-17T20:55:12.000000999+02:00[Europe/Paris]

{style="table-layout:auto"}

Hiérarchies - Objets

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
size_of Renvoie la taille de l'entrée.
  • ENTRÉE : Obligatoire L'objet dont vous essayez de trouver la taille.
size_of(INPUT) size_of([1, 2, 3, 4]) 4
is_blank Vérifie si un objet est vide ou non.
  • ENTRÉE : Obligatoire L'objet que vous essayez de vérifier est vide.
is_blank(INPUT) is_empty([1, 2, 3]) false
array_to_object Crée une liste d’objets.
  • ENTRÉE : Obligatoire Groupe de paires de clés et de tableaux.
array_to_object(INPUT) exemple nécessaire exemple nécessaire
to_object Crée un objet basé sur les paires clé/valeur plate données.
  • ENTRÉE : Obligatoire Liste plate de paires clé/valeur.
to_object(INPUT) to_object ​("firstName", "John", "lastName", "Doe") {"firstName": "John", "lastName": "Doe"}
str_to_object Crée un objet à partir de la chaîne d’entrée.
  • CHAÎNE : Obligatoire Chaîne analysée pour créer un objet.
  • VALUE_DELIMITER : Facultatif Délimiteur qui sépare un champ de la valeur. Le délimiteur par défaut est :.
  • FIELD_DELIMITER : Facultatif Délimiteur qui sépare les paires de valeurs de champ. Le délimiteur par défaut est ,.
str_to_object ​(STRING, VALUE_DELIMITER, FIELD_DELIMITER) str_to_object("firstName - John lastName -
contient_key Vérifie si l'objet existe dans les données source. Remarque : Cette fonction remplace la fonction obsolète is_set() fonction.
  • ENTRÉE : Obligatoire Chemin d’accès à vérifier s’il existe dans les données source.
includes_key(INPUT) contents_key("evars.evar.field1") vrai
annuler Définit la valeur de l’attribut sur null. Cette option doit être utilisée lorsque vous ne souhaitez pas copier le champ dans le schéma cible. nullify() nullify() null
get_keys Analyse les paires clé/valeur et renvoie toutes les clés.
  • OBJET : Obligatoire Objet à partir duquel les clés seront extraites.
get_keys(OBJECT) get_keys({"book1") : "Fierté et préjugé", "book2" : "1984"}) ["book1", "book2"]
get_values Analyse les paires clé/valeur et renvoie la valeur de la chaîne, en fonction de la clé donnée.
  • CHAÎNE : Obligatoire Chaîne que vous souhaitez analyser.
  • CLÉ : Obligatoire La clé pour laquelle la valeur doit être extraite.
  • VALUE_DELIMITER : Obligatoire Le délimiteur qui sépare le champ de la valeur. Si null ou une chaîne vide est fournie, cette valeur est :.
  • FIELD_DELIMITER : Facultatif Délimiteur qui sépare les paires de champs et de valeurs. Si null ou une chaîne vide est fournie, cette valeur est ,.
get_values(STRING, KEY, VALUE_DELIMITER, FIELD_DELIMITER) get_values("firstName - John, lastName - Cena, téléphone - 555 420 8692", "firstName", "-", ",") John

Hiérarchies - Tableaux

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
coalesce Renvoie le premier objet non nul dans un tableau donné.
  • ENTRÉE : Obligatoire Tableau dont vous souhaitez trouver le premier objet non nul.
coalesce(INPUT) coalesce(null, null, null, "first", null, "second") "first"
first Récupère le premier élément du tableau donné.
  • ENTRÉE : Obligatoire Tableau dont vous souhaitez trouver le premier élément.
first(INPUT) first("1", "2", "3") "1"
last Récupère le dernier élément du tableau donné.
  • ENTRÉE : Obligatoire Tableau dont vous souhaitez trouver le dernier élément.
last(INPUT) last("1", "2", "3") "3"
add_to_array Ajoute des éléments à la fin du tableau.
  • ARRAY : Obligatoire Tableau auquel vous ajoutez des éléments.
  • VALEURS : Les éléments que vous souhaitez ajouter au tableau.
add_to_array ​(ARRAY, VALUES) add_to_array ​(['a', 'b'], "c", "d") [a, b, c, d]
join_array Combine les tableaux les uns avec les autres.
  • ARRAY : Obligatoire Tableau auquel vous ajoutez des éléments.
  • VALEURS : La ou les baies que vous souhaitez ajouter à la baie parent.
jointure_array ​(ARRAY, VALUES) join_array ​(['a', 'b'], ["c"], ['d', 'e']) [a, b, c, d, e]
to_array Prend une liste d’entrées et la convertit en tableau.
  • INCLUDE_NULLS : Obligatoire Valeur booléenne indiquant si les valeurs nulles doivent être incluses ou non dans le tableau de réponses.
  • VALEURS : Obligatoire Les éléments à convertir en tableau.
to_array ​(INCLUDE_NULLS, VALUES) to_array(false, 1, null, 2, 3) [1, 2, 3]

Opérateurs logiques

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
decode Étant donné qu’une clé et une liste de paires clé-valeur sont aplaties dans un tableau, la fonction renvoie la valeur si la clé est trouvée ou renvoie une valeur par défaut si elle est présente dans le tableau.
  • CLÉ : Obligatoire La clé à mettre en correspondance.
  • OPTIONS : Obligatoire Tableau aplati de paires clé/valeur. Si vous le souhaitez, une valeur par défaut peut être définie à la fin.
decode(KEY, OPTIONS) decode(stateCode, "ca", "California", "pa", "Pennsylvania", "N/A") Si le code d'état donné est "ca", "California".
Si le code d'état donné est "pa", "Pennsylvania".
Si la propriété stateCode ne correspond pas à la propriété suivante, "S/O".
iif Évalue une expression booléenne donnée et renvoie la valeur spécifiée en fonction du résultat.
  • EXPRESSION : Obligatoire Expression booléenne en cours d'évaluation.
  • TRUE_VALUE : Obligatoire Valeur renvoyée si l’expression est évaluée sur true.
  • FALSE_VALUE : Obligatoire Valeur renvoyée si l’expression est évaluée sur false.
iif(EXPRESSION, TRUE_VALUE, FALSE_VALUE) iif("s".equalsIgnoreCase("S"), "True", "False") "True"

Agrégation

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
min Renvoie le minimum des arguments donnés. Utilise l’ordre naturel.
  • OPTIONS : Obligatoire Un ou plusieurs objets pouvant être comparés.
min(OPTIONS) min(3, 1, 4) 1
max Renvoie le maximum des arguments donnés. Utilise l’ordre naturel.
  • OPTIONS : Obligatoire Un ou plusieurs objets pouvant être comparés.
max(OPTIONS) max(3, 1, 4) 4

Conversions de type

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
to_bigint Convertit une chaîne en objet BigInteger.
  • CHAÎNE : Obligatoire Chaîne à convertir en type BigInteger.
to_bigint(STRING) to_bigint ​("1000000.34") 1000000,34
to_decimal Convertit une chaîne en double.
  • CHAÎNE : Obligatoire Chaîne à convertir en double.
to_decimal(STRING) to_decimal("20.5") 20,5
to_float Convertit une chaîne en virgule flottante.
  • CHAÎNE : Obligatoire Chaîne à convertir en Flottant.
to_float(STRING) to_float("12.3456") 12,34566
to_entier Convertit une chaîne en entier.
  • CHAÎNE : Obligatoire Chaîne à convertir en entier.
to_entier(STRING) to_entier("12") 12

Fonctions JSON

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
json_to_object Désérialise le contenu JSON à partir de la chaîne donnée.
  • CHAÎNE : Obligatoire Chaîne JSON à désérialiser.
json_to_object ​(STRING) json_to_object ​({"info":{"firstName":"John","lastName" : "Doe"}}) Objet représentant le fichier JSON.

Opérations spéciales

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
uuid /
guid
Génère un identifiant pseudo-aléatoire. uuid()
guid()
uuid()
guid()
7c0267d2-bb74-4e1a-9275-3bf4fcda5f4
c7016dc7-3163-43f7-afc7-2e1c9c206333

Fonctions de l'agent utilisateur

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Fonction Description Paramètres Syntaxe Expression Exemple de résultat
ua_os_name Extrait le nom du système d'exploitation de la chaîne de l'agent utilisateur.
  • USER_AGENT : Obligatoire Chaîne de l'agent utilisateur.
ua_os_name ​(USER_AGENT) ua_os_name ​("Mozilla/5.0 (iPhone ; Processeur iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3") iOS
ua_os_version_major Extrait la version principale du système d'exploitation de la chaîne de l'agent utilisateur.
  • USER_AGENT : Obligatoire Chaîne de l'agent utilisateur.
ua_os_version_major ​(USER_AGENT) ua_os_version_major ​ s("Mozilla/5.0 (iPhone ; Processeur iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3") iOS 5
ua_os_version Extrait la version du système d'exploitation de la chaîne de l'agent utilisateur.
  • USER_AGENT : Obligatoire Chaîne de l'agent utilisateur.
ua_os_version ​(USER_AGENT) ua_os_version ​("Mozilla/5.0 (iPhone ; Processeur iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3") 5.1.1
ua_os_name_version Extrait le nom et la version du système d'exploitation de la chaîne de l'agent utilisateur.
  • USER_AGENT : Obligatoire Chaîne de l'agent utilisateur.
ua_os_name_version ​(USER_AGENT) ua_os_name_version ​("Mozilla/5.0 (iPhone ; Processeur iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3") iOS 5.1.1
ua_agent_version Extrait la version de l'agent de la chaîne de l'agent utilisateur.
  • USER_AGENT : Obligatoire Chaîne de l'agent utilisateur.
ua_agent_version ​(USER_AGENT) ua_agent_version ​("Mozilla/5.0 (iPhone ; Processeur iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3") 5.1
ua_agent_version_major Extrait le nom de l'agent et la version principale de la chaîne de l'agent utilisateur.
  • USER_AGENT : Obligatoire Chaîne de l'agent utilisateur.
ua_agent_version_major ​(USER_AGENT) ua_agent_version_major ​("Mozilla/5.0 (iPhone ; Processeur iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3") Safari 5
ua_agent_name Extrait le nom de l'agent de la chaîne de l'agent utilisateur.
  • USER_AGENT : Obligatoire Chaîne de l'agent utilisateur.
ua_agent_name ​(USER_AGENT) ua_agent_name ​("Mozilla/5.0 (iPhone ; Processeur iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3") Safari
ua_device_class Extrait la classe device de la chaîne de l'agent utilisateur.
  • USER_AGENT : Obligatoire Chaîne de l'agent utilisateur.
ua_device_class ​(USER_AGENT) ua_device_class ​("Mozilla/5.0 (iPhone ; Processeur iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3") Téléphone

Sur cette page