Fonctions d’expression dans le flux de données de mappage

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Les flux de données sont disponibles à la fois dans les pipelines Azure Data Factory et Azure Synapse. Cet article s’applique aux flux de données de mappage. Si vous débutez dans le domaine des transformations, consultez l’article d’introduction Transformer des données avec un flux de données de mappage.

Les articles suivants fournissent des détails sur les fonctions d’expressions prises en charge par Azure Data Factory et Azure Synapse Analytics dans les flux de données de mappage.

Liste de fonctions d’expressions

Dans les pipelines Data Factory et Synapse, utilisez le langage d’expression de la fonctionnalité de flux de données de mappage pour configurer les transformations de données.

Fonction d’expression Tâche
abs Valeur absolue d’un nombre.
acos Calcule une valeur inverse de cosinus.
add Ajoute une paire de chaînes ou de nombres. Ajoute une date à un nombre de jours. Ajoute une durée à un timestamp. Ajoute un tableau à un autre de type similaire. Identique à l’opérateur +.
and Opérateur AND logique. Comme pour &&.
asin Calcule une valeur de sinus inverse.
assertErrorMessages Retourne le mappage de tous les messages d’assertion.
atan Calcule une valeur de tangente inverse.
atan2 Retourne l’angle (en radians) qui se trouve entre l’axe positif des abscisses d’un plan et le point donné par les coordonnées.
between Vérifie si la première valeur est comprise entre deux autres valeurs incluses. Les valeurs numériques, de chaîne et DateHeure peuvent être comparées
bitwiseAnd Opérateur And au niveau du bit sur des types de données intégraux. Identique à l’opérateur &.
bitwiseOr Opérateur Or au niveau du bit sur des types de données intégraux. Identique à l’opérateur |.
bitwiseXor Opérateur Or au niveau du bit sur des types de données intégraux. Identique à l’opérateur |.
blake2b Calcule le code de hachage Blake2 d’un ensemble de colonnes de types de données primitifs variables en fonction d’une longueur en bits. La longueur en bits ne peut être qu’un multiple de huit compris entre huit et 512. Il peut être utilisé dans le but de calculer une empreinte digitale pour une ligne.
blake2bBinary Calcule le code de hachage Blake2 de l’ensemble de colonnes comprenant différents types de données primitifs à partir d’une longueur en bits, qui peut uniquement être égale aux multiples de huit compris entre huit et 512. Il peut être utilisé dans le but de calculer une empreinte digitale pour une ligne
case Selon des conditions alternantes, applique une valeur ou une autre. Si les entrées sont en nombre égal, l’autre valeur est Null par défaut pour la dernière condition.
cbrt Calcule la racine cubique d’un nombre.
ceil Retourne le plus petit entier qui n’est pas inférieur au nombre.
coalesce Renvoie la première valeur non nulle d'un jeu d'entrées. Toutes les entrées doivent être du même type.
columnNames Obtient les noms de toutes les colonnes de sortie pour un flux. Vous pouvez passer un nom de flux facultatif comme premier argument et un second argument facultatif pour retourner uniquement les colonnes de dérive de schéma.
columns Obtient les valeurs de toutes les colonnes de sortie pour un flux. Vous pouvez transmettre un nom de flux facultatif en tant que deuxième argument.
compare Compare deux valeurs du même type. Retourne un entier négatif si valeur1 <valeur2, 0 si valeur1 == valeur2, une valeur positive si valeur1 > valeur2.
concat Concatène un nombre variable de chaînes. Identique à l’opérateur + avec des chaînes.
concatWS Concatène un nombre variable de chaînes avec un séparateur. Le premier paramètre est le séparateur.
cos Calcule une valeur de cosinus.
cosh Calcule le cosinus hyperbolique d’une valeur.
crc32 Calcule le hachage CRC32 de l’ensemble de colonnes comprenant différents types de données primitives à partir d’une longueur en bits. La longueur en bits peut uniquement être égale aux valeurs 0 (256), 224, 256, 384 ou 512. Il peut être utilisé dans le but de calculer une empreinte digitale pour une ligne.
degrees Convertit les radians en degrés.
divide Divise une paire de nombres. Identique à l’opérateur /.
dropLeft Supprime le nombre de caractères nécessaire à partir de la gauche de la chaîne. Si le nombre à supprimer est supérieur à la longueur de la chaîne, une chaîne vide est retournée.
dropRight Supprime le nombre de caractères nécessaire à partir de la droite de la chaîne. Si le nombre à supprimer est supérieur à la longueur de la chaîne, une chaîne vide est retournée.
endsWith Vérifie si la chaîne se termine par la chaîne fournie.
equals Opérateur de comparaison « Est égal à » Identique à l’opérateur ==.
equalsIgnoreCase Opérateur de comparaison « Est égal à » qui ignore la casse. Identique à l’opérateur <=>.
escape Échappe une chaîne conformément à un format. Les valeurs littérales pour le format acceptable sont « json », « xml », « ecmascript », « html », « java ».
expr Génère une expression à partir d’une chaîne. Équivaut à écrire l’expression sous une forme non littérale, et peut être utilisé pour passer des paramètres en tant que représentations sous forme de chaîne.
factorial Calcule la factorielle d’un nombre.
false Retourne toujours une valeur false. Utilisez la fonction syntax(false()) s’il existe une colonne nommée « false ».
floor Retourne le plus grand entier qui n’est pas supérieur au nombre.
fromBase64 Décode la chaîne encodée en base64.
greater Opérateur de comparaison « Supérieur à » Identique à l’opérateur >.
greaterOrEqual Opérateur de comparaison « Supérieur ou égal à ». Identique à l’opérateur >=.
greatest Retourne la valeur la plus élevée parmi celles de la liste des valeurs d’entrée, en ignorant les valeurs Null. Retourne la valeur Null si toutes les entrées ont une valeur Null.
hasColumn Vérifie une valeur de colonne par son nom dans le flux de données. Vous pouvez transmettre un nom de flux facultatif en tant que deuxième argument. Les noms de colonne connus au moment de la conception doivent être traités uniquement selon leur nom. Les entrées calculées ne sont pas prises en charge, mais vous pouvez utiliser des substitutions de paramètre.
hasError Vérifie si l’assertion avec l’ID fourni est marquée comme erreur.
iif Selon la condition, applique une valeur ou une autre. Si l’autre valeur n’est pas spécifiée, elle est considérée comme Null. Les deux valeurs doivent être compatibles (numérique, chaîne...).
iifNull À partir de deux entrées ou plus, retourne le premier élément non null. Cette fonction est équivalente à coalesce.
initCap Convertit la première lettre de chaque mot en majuscules. Les mots sont identifiés comme étant séparés par des espaces blancs.
instr Recherche la position (de base 1) de la sous-chaîne au sein d’une chaîne. Si elle est introuvable, 0 est retourné.
isDelete Vérifie si la ligne est marquée pour la suppression. Pour les transformations qui acceptent plusieurs flux d’entrée, vous pouvez passer l’index (de base 1) du flux. L’index de flux doit être 1 ou 2 et la valeur par défaut est 1.
isError Vérifie si la ligne est marquée comme comprenant une erreur. Pour les transformations qui acceptent plusieurs flux d’entrée, vous pouvez passer l’index (de base 1) du flux. L’index de flux doit être 1 ou 2 et la valeur par défaut est 1.
isIgnore Vérifie si la ligne est marquée comme devant être ignorée. Pour les transformations qui acceptent plusieurs flux d’entrée, vous pouvez passer l’index (de base 1) du flux. L’index de flux doit être 1 ou 2 et la valeur par défaut est 1.
isInsert Vérifie si la ligne est marquée pour l’insertion. Pour les transformations qui acceptent plusieurs flux d’entrée, vous pouvez passer l’index (de base 1) du flux. L’index de flux doit être 1 ou 2 et la valeur par défaut est 1.
isMatch Vérifie si la ligne correspond à la recherche. Pour les transformations qui acceptent plusieurs flux d’entrée, vous pouvez passer l’index (de base 1) du flux. L’index de flux doit être 1 ou 2 et la valeur par défaut est 1.
isNull Vérifie si la valeur est NULL.
isUpdate Vérifie si la ligne est marquée pour la mise à jour. Pour les transformations qui acceptent plusieurs flux d’entrée, vous pouvez passer l’index (de base 1) du flux. L’index de flux doit être 1 ou 2 et la valeur par défaut est 1.
IsUpsert Vérifie si la ligne est marquée pour l’insertion. Pour les transformations qui acceptent plusieurs flux d’entrée, vous pouvez passer l’index (de base 1) du flux. L’index de flux doit être 1 ou 2 et la valeur par défaut est 1.
jaroWinkler Obtient la distance JaroWinkler entre deux chaînes.
least Opérateur de comparaison « Inférieur ou égal à ». Identique à l’opérateur <=.
left Extrait une sous-chaîne comportant un certain nombre de caractères en partant de la gauche d’une chaîne au niveau de l’index 1. Identique à SUBSTRING(str, 1, n).
length Retourne la longueur de la chaîne.
lesser Opérateur de comparaison « Inférieur à » Identique à l’opérateur <.
lesserOrEqual Opérateur de comparaison « Inférieur ou égal à ». Identique à l’opérateur <=.
levenshtein Obtient la distance levenshtein entre deux chaînes.
like Le modèle est une chaîne qui est mise en correspondance littéralement. Les symboles spéciaux suivants représentent des exceptions : _ correspond à tout caractère de l’entrée (semblable à . dans les expressions régulières posix)
locate Recherche la position (de base 1) de la sous-chaîne au sein d’une chaîne, en partant d’une certaine position. Si la position est omise, on considère qu’elle est située au début de la chaîne. Si elle est introuvable, 0 est retourné.
log Calcule la valeur de journal. Une base facultative peut être fournie, voire un nombre Euler, le cas échéant.
log10 Calcule la valeur de journal sur une base 10.
lower Convertit une chaîne en minuscules.
lpad Décale la chaîne sur la gauche selon la marge intérieure fournie, jusqu’à ce qu’elle atteigne une certaine longueur. Si la longueur de la chaîne est supérieure ou égale à cette longueur, elle est tronquée à la longueur.
ltrim Supprime une chaîne de caractères de début situés sur la gauche. Si le deuxième paramètre n’est pas spécifié, cela supprime l’espace blanc. Sinon, cela supprime tout caractère spécifié dans le deuxième paramètre.
md5 Calcule le code de hachage MD5 de l’ensemble de colonnes comprenant différents types de données primitives, et retourne une chaîne hexadécimale de 32 caractères. Il peut être utilisé dans le but de calculer une empreinte digitale pour une ligne.
minus Soustrait des nombres. Soustrait le nombre de jours à une date. Soustrait une durée d’un timestamp. Soustrait deux timestamps pour obtenir la différence en millisecondes. Identique à l’opérateur -.
mod Module une paire de nombres. Identique à l’opérateur %.
multiply Multiplie une paire de nombres. Identique à l’opérateur *.
negate Inverse un nombre. Transforme les nombres positifs en nombres négatifs, et vice versa.
nextSequence Retourne la séquence unique suivante. Le nombre est consécutif uniquement au sein d’une partition et il est préfixé de partitionId.
normalize Normalise la valeur de chaîne pour séparer les caractères Unicode accentués.
not Opérateur de négation logique.
notEquals Opérateur de comparaison « N'est pas égal à » Identique à l’opérateur !=.
null Retourne une valeur NULL. Utilisez la fonction syntax(null()) s’il existe une colonne nommée « null ». Toute opération qui l’utilise entraînera une valeur NULL.
or Opérateur OR logique. Identique à ||.
pMod Module positivement une paire de nombres.
partitionId Retourne l’ID de partition actuel où se trouve la ligne d’entrée.
puissance Élève un nombre à la puissance d’un autre nombre.
radians Convertit les degrés en radians.
random Retourne un nombre aléatoire selon une valeur initiale facultative dans une partition. La valeur initiale doit être une valeur fixe, et elle est utilisée avec la valeur partitionId pour produire des valeurs aléatoires
regexExtract Extrait une sous-chaîne correspondant à un modèle d’expression régulière donné. Le dernier paramètre identifie le groupe de correspondance. S’il est omis, la valeur par défaut est de 1. Utilisez `<regex>` (apostrophe ouvrante) pour rechercher une chaîne sans séquence d’échappement.
regexMatch Vérifie si la chaîne correspond au modèle d’expression régulière donné. Utilisez `<regex>` (apostrophe ouvrante) pour rechercher une chaîne sans séquence d’échappement.
regexReplace Remplace toutes les occurrences d’un modèle d’expression régulière par une autre sous-chaîne d’une chaîne donnée. Utilisez `<regex>` (apostrophe ouvrante) pour rechercher une chaîne sans séquence d’échappement.
regexSplit Fractionne une chaîne selon un délimiteur basé sur une expression régulière et retourne un tableau de chaînes.
replace Remplace toutes les occurrences d’une sous-chaîne par une autre sous-chaîne dans une chaîne donnée. Si le dernier paramètre est omis, sa valeur par défaut est une chaîne vide.
reverse Inverse une chaîne.
right Extrait une sous-chaîne comportant un certain nombre de caractères en partant de la droite. Identique à SUBSTRING(str, LENGTH(str) - n, n).
rlike Vérifie si la chaîne correspond au modèle d’expression régulière donné.
round Arrondit un nombre donné selon une mise à l’échelle et un mode d’arrondi facultatifs. Si l’échelle est omise, la valeur par défaut 0 est utilisée. Si le mode est omis, la valeur par défaut ROUND_HALF_UP(5) est utilisée. Les valeurs de l’arrondi incluent
rpad Décale la chaîne sur la droite selon la marge intérieure fournie, jusqu’à ce qu’elle atteigne une certaine longueur. Si la longueur de la chaîne est supérieure ou égale à cette longueur, elle est tronquée à la longueur.
rtrim Supprime une chaîne de caractères de début situés sur la droite. Si le deuxième paramètre n’est pas spécifié, cela supprime l’espace blanc. Sinon, cela supprime tout caractère spécifié dans le deuxième paramètre.
sha1 Calcule le code de hachage SHA-1 de l’ensemble de colonnes comprenant différents types de données primitives, et retourne une chaîne hexadécimale de 40 caractères. Il peut être utilisé dans le but de calculer une empreinte digitale pour une ligne.
sha2 Calcule le code de hachage SHA-2 de l’ensemble de colonnes comprenant différents types de données primitives à partir d’une longueur en bits, qui peut uniquement être égale aux valeurs 0(256), 224, 256, 384, 512. Il peut être utilisé dans le but de calculer une empreinte digitale pour une ligne.
sin Calcule une valeur de sinus.
sinh Calcule une valeur de sinus hyperbolique.
soundex Obtient le code soundex de la chaîne.
split Fractionne une chaîne selon un délimiteur et retourne un tableau de chaînes.
sqrt Calcule la racine carrée d’un nombre.
startsWith Vérifie si la chaîne commence par la chaîne fournie.
substring Extrait une sous-chaîne d’une certaine longueur en partant d’une position. La position est de base 1. Si la longueur est omise, elle est définie par défaut sur la fin de la chaîne.
substringIndex Extrait le substring avant les occurrences count du délimiteur. Si count est positif, tout ce qui se trouve à gauche du délimiteur final (en partant de la gauche) est retourné. Si count est négatif, tout ce qui se trouve à droite du délimiteur final (en partant de la droite) est retourné.
tan Calcule une valeur de tangente.
tanh Calcule une valeur de tangente hyperbolique.
translate Remplace un jeu de caractères par un autre jeu de caractères dans la chaîne. Chaque caractère est remplacé par un seul caractère.
trim Supprime une chaîne de caractères de début et de fin. Si le deuxième paramètre n’est pas spécifié, cela supprime l’espace blanc. Sinon, cela supprime tout caractère spécifié dans le deuxième paramètre.
true Retourne toujours une valeur true. Utilisez la fonction syntax(true()) s’il existe une colonne nommée « true ».
typeMatch Correspond au type de la colonne. Peut uniquement être utilisé dans les expressions de modèle. « number » peut être de type short, integer, long, double, float ou decimal ; « integral » peut être de type short, integer ou long ; « fractional » peut être de type double, float ou decimal et « datetime » peut être de type date ou timestamp.
unescape Annule l’échappement d’une chaîne conformément à un format. Les valeurs littérales pour le format acceptable sont « json », « xml », « ecmascript », « html », « java ».
upper Convertit une chaîne en majuscules.
uuid Retourne l’UUID généré.
xor Opérateur logique XOR. Identique à l’opérateur ^.

Étapes suivantes