Partager via

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

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Conseil

Essayez Data Factory dans Microsoft Fabric, une solution d’analyse tout-en-un pour les entreprises. Microsoft Fabric couvre tous les aspects, du déplacement des données à la science des données, en passant par l’analyse en temps réel, la business intelligence et le reporting. Découvrez comment démarrer un nouvel essai gratuitement !

Les flux de données sont disponibles dans les pipelines Azure Data Factory et les pipelines Azure Synapse Analytics. Cet article s’applique aux flux de données de mappage. Si vous débutez avec les transformations, reportez-vous à l’article d’introduction Transformer des données à l’aide de flux de données de mappage.

Cet article fournit des détails sur les fonctions d’expression 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 Azure Data Factory et Azure Synapse Analytics, 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 Donne la 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 horodatage. Ajoute un tableau à un autre de type similaire. Identique à l’opérateur +.
and Utilise l’opérateur logique AND . Identique à &&.
asin Calcule une valeur de sinus inverse.
assertErrorMessages Retourne une carte 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. Vous pouvez comparer des valeurs numériques, des chaînes et datetime.
bitwiseAnd Utilise l’opérateur binaire And entre les types intégraux. Identique à l’opérateur &.
bitwiseOr Utilise l'opérateur binaire Or entre les types intégraux. Identique à l’opérateur |.
bitwiseXor Utilise l'opérateur au niveau des bits Or sur les types intégraux. Identique à l’opérateur |.
blake2b Calcule le digest Blake2 d’un ensemble de colonnes de différents types de données primitifs en fonction d’une longueur de bits. La longueur en bits ne peut être qu’un multiple de huit compris entre huit et 512. Vous pouvez l’utiliser pour calculer une empreinte digitale pour une ligne.
blake2bBinary Calcule la synthèse Blake2 d’un ensemble de colonnes de types de données primitifs variables en fonction d’une longueur de bits, qui ne peut être que plusieurs de 8 entre 8 et 512. Vous pouvez l’utiliser pour calculer une empreinte digitale pour une ligne.
case Applique une valeur ou l’autre en fonction de conditions alternées. Si le nombre d’entrées est pair, l’autre est défini 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 deuxième argument facultatif pour renvoyer 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 ou 0 si valeur1 == valeur2, et retourne 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 d’un ensemble de colonnes de différents types de données primitifs en fonction d’une longueur de bits. La longueur du bit doit être de valeurs 0 (256), 224, 256, 384, et 512. Vous pouvez l’utiliser pour 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 autant de caractères que spécifiés à 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 autant de caractères que spécifiés à 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 Utilise l’opérateur de comparaison « Égal à ». Identique à l’opérateur ==.
equalsIgnoreCase Utilise l’opérateur de comparaison « Égal » et 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, , xmlecmascript, htmlet java.
expr Génère une expression à partir d’une chaîne. Équivaut à écrire l’expression dans une forme nonlite. Vous pouvez l’utiliser pour passer des paramètres en tant que représentations sous forme de chaînes.
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 spécifique.
greater Utilise l’opérateur de comparaison « Supérieur à ». Identique à l’opérateur >.
greaterOrEqual Utilise l’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 colonnes connus à la conception doivent être référencés uniquement à l’aide de leur nom. Les entrées calculées ne sont pas prises en charge, mais vous pouvez utiliser des substitutions de paramètres.
hasError Vérifie si l’assertion avec l’ID fourni est marquée comme une erreur.
iif Applique une valeur ou l’autre en fonction d’une condition. Si l’autre n’est pas spécifié, la valeur est considérée NULL. Les deux valeurs doivent être compatibles (par exemple, numériques ou chaînes).
iifNull Retourne le premier élément non null lorsqu’il reçoit deux entrées ou plus. 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 (basée sur 1) de la sous-chaîne dans une chaîne. S’il est introuvable, 0 est retourné.
isDelete Vérifie si la ligne est marquée pour la suppression. Pour les transformations qui prennent plusieurs flux d’entrée, vous pouvez passer l’index (basé sur 1) du flux. L’index de flux doit être soit 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 prennent plusieurs flux d’entrée, vous pouvez passer l’index (basé sur 1) du flux. L’index de flux doit être soit 1 soit 2. La valeur par défaut est 1.
isIgnore Vérifie si la ligne doit être ignorée. Pour les transformations qui prennent plusieurs flux d’entrée, vous pouvez passer l’index (basé sur 1) du flux. L’index de flux doit être soit 1 soit 2. La valeur par défaut est 1.
isInsert Vérifie si la ligne est marquée pour l’insertion. Pour les transformations qui prennent plusieurs flux d’entrée, vous pouvez passer l’index (basé sur 1) du flux. L’index de flux doit être soit 1 soit 2. La valeur par défaut est 1.
isMatch Vérifie si la ligne correspond à la recherche. Pour les transformations qui prennent plusieurs flux d’entrée, vous pouvez passer l’index (basé sur 1) du flux. L’index de flux doit être soit 1 soit 2. 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 prennent plusieurs flux d’entrée, vous pouvez passer l’index (basé sur 1) du flux. L’index de flux doit être soit 1 soit 2. La valeur par défaut est 1.
isUpsert Vérifie si la ligne est marquée pour l’insertion. Pour les transformations qui prennent plusieurs flux d’entrée, vous pouvez passer l’index (basé sur 1) du flux. L’index de flux doit être soit 1 soit 2. La valeur par défaut est 1.
jaroWinkler Obtient la distance JaroWinkler entre deux chaînes.
least Utilise l’opérateur de comparaison « Inférieur ou égal à ». Identique à l’opérateur <=.
left Extrait une sous-chaîne commençant à l’index 1 avec le nombre de caractères. Identique à SUBSTRING(str, 1, n).
length Retourne la longueur de la chaîne.
lesser Utilise l’opérateur de comparaison « Inférieur à ». Identique à l’opérateur <.
lesserOrEqual Utilise l’opérateur de comparaison « Inférieur ou égal à ». Identique à l’opérateur <=.
levenshtein Obtient la distance levenshtein entre deux chaînes.
like Utilise un modèle avec une chaîne qui correspond littéralement. L’exception est le symbole _ spécial qui correspond à un caractère dans l’entrée (similaire à .* dans les posix expressions régulières).
locate Recherche la position (de base 1) de la sous-chaîne au sein d’une chaîne partant d’une certaine position. Si la position est omise, commencez à partir du début de la chaîne. S’il est introuvable, 0 est retourné.
log Calcule la valeur logarithmique. Vous pouvez fournir une base facultative ou un numéro Euler si utilisé.
log10 Calcule la valeur logarithmique en 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, la chaîne 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é, il supprime les espaces blancs. Sinon, il supprime tout caractère spécifié dans le deuxième paramètre.
md5 Calcule la synthèse MD5 d’un ensemble de colonnes de différents types de données primitifs et retourne une chaîne hexadécimal de 32 caractères. Vous pouvez l’utiliser pour calculer une empreinte digitale pour une ligne.
minus Soustrait des nombres. Soustrait le nombre de jours à partir d'une date. Soustrait la durée d’un horodatage. Soustraire deux horodatages afin d'obtenir la différence en millisecondes. Identique à l’opérateur -.
mod Donne le module d’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 dans une partition et est précédé de l’ID de partition.
normalize Normalise la valeur de chaîne pour séparer les caractères Unicode accentués.
not Utilise l’opérateur de négation logique.
notEquals Utilise l’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 génère un NULL.
or Utilise l’opérateur logique OR . Identique à ||.
pMod Donne les modulus positifs d’une paire de nombres.
partitionId Retourne l'ID actuel de partition dans lequel 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 lorsqu'une graine facultative est donnée au sein d'une partition. La valeur initiale doit être une valeur fixe et est utilisée avec l’ID de partition pour produire des valeurs aléatoires.
regexExtract Extrait une sous-chaîne correspondante pour un modèle d’expression régulière spécifique. Le dernier paramètre identifie le groupe de correspondance et la valeur par défaut est 1 s’il est omis. Utilise `<regex>` pour rechercher une chaîne sans séquence d’échappement.
regexMatch Vérifie si la chaîne correspond au modèle regex spécifique. Utilise `<regex>` pour rechercher une chaîne sans séquence d’échappement.
regexReplace Remplace toutes les occurrences d’un modèle regex par une autre sous-chaîne dans la chaîne spécifique. Utilise `<regex>` 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 la chaîne spécifique. Si le dernier paramètre est omis, il est défini par défaut sur une chaîne vide.
reverse Inverse une chaîne.
right Extrait une sous-chaîne avec le 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 regex spécifique.
round Arrondit un nombre en fonction d’une échelle facultative et d’un mode d’arrondi facultatif. Si l’échelle est omise, la valeur par défaut est 0. Si le mode est omis, il est défini par défaut sur ROUND_HALF_UP(5).
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, la chaîne 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é, il supprime les espaces blancs. Sinon, il supprime tout caractère spécifié dans le deuxième paramètre.
sha1 Calcule la synthèse SHA-1 d’un ensemble de colonnes de différents types de données primitifs et retourne une chaîne hexadécimal de 40 caractères. Vous pouvez l’utiliser pour calculer une empreinte digitale pour une ligne.
sha2 Calcule la synthèse SHA-2 d’un ensemble de colonnes de types de données primitifs variables en fonction d’une longueur de bits, qui ne peut être de valeurs 0 (256), 224, , 256, 384et 512. Vous pouvez l’utiliser pour 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 par défaut à 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 ensemble de caractères par un autre ensemble de caractères dans la chaîne. Les caractères ont un remplacement un-à-un.
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é, il supprime les espaces blancs. Sinon, il supprime tout caractère spécifié dans le deuxième paramètre.
true Retourne toujours une valeur true. Utilisez la fonction syntax(true()) si une colonne est nommée true.
typeMatch Correspond au type de la colonne. Utilisé uniquement dans les expressions de modèle. Le nombre correspond à court, entier, long, double, float ou décimal. L’intégrale correspond à court, entier et long. Les nombres fractionnaires correspondent aux types double, float et decimal. Date/Heure correspond au type d’horodatage de date ou d’heure.
unescape Annule l’échappement d’une chaîne conformément à un format. Les valeurs littérales pour le format acceptable sont json, , xmlecmascript, htmlet java.
upper Convertit une chaîne en majuscules.
uuid Retourne l’UUID généré.
xor Renvoie l'opérateur logique XOR. Identique à l’opérateur ^.

Contenu connexe

  • Last updated on