Expressions et fonctions pour Data Factory dans Microsoft Fabric

Cet article fournit des détails sur les expressions et les fonctions prises en charge par Data Factory dans Microsoft Fabric.

Expressions

Les valeurs d’expression dans la définition peuvent être des expressions littérales ou évaluées au moment de l’exécution. Par exemple:

"value"

ou

"@pipeline().parameters.password"

Les expressions peuvent apparaître n’importe où dans une valeur de chaîne et entraînent toujours une autre valeur de chaîne. Si une valeur est une expression, le corps de l’expression est extrait en supprimant le signe at-sign (@). Si une chaîne littérale est nécessaire qui commence par @, elle doit être échappée à l’aide de @@. Les exemples suivants montrent comment les expressions sont évaluées.

Les expressions peuvent également apparaître à l’intérieur de chaînes, à l’aide d’une fonctionnalité appelée interpolation de chaîne dans laquelle les expressions sont encapsulées @{ ... }. Par exemple : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

À l’aide de l’interpolation de chaîne, le résultat est toujours une chaîne. Supposons que j’ai défini myNumber comme 42 et myString comme foo:

Dans les activités de flux de contrôle comme l’activité ForEach, vous pouvez fournir un tableau sur lequel effectuer une itération pour les éléments de propriété et l’utiliser @item() pour itérer sur une énumération unique dans l’activité ForEach. Par exemple, si les éléments sont un tableau : [1, 2, 3], @item() retourne 1 dans la première itération, 2 dans la deuxième itération et 3 dans la troisième itération. Vous pouvez également utiliser @range(0,10) comme expression pour itérer 10 fois à partir de 0 se terminant par 9.

Vous pouvez utiliser @activity(« nom d’activité » pour capturer la sortie de l’activité et prendre des décisions. Considérez une activité web appelée Web1. Pour placer la sortie de la première activité dans le corps de la seconde, l’expression ressemble généralement à : @activity(« Web1 ». output ou @activity(« Web1 »). output.data ou quelque chose de similaire en fonction de la sortie de la première activité.

Examples

Exemple d’expression complexe

L’exemple ci-dessous montre un exemple complexe qui fait référence à un sous-champ de sortie d’activité approfondi. Pour référencer un paramètre de pipeline qui prend la valeur d’un sous-champ, utilisez la syntaxe [] au lieu d’opérateur dot(.) (comme dans le cas de sous-champ1 et de sous-champ2), dans le cadre d’une sortie d’activité.

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

La création de fichiers dynamiquement et leur nommage est un modèle courant. Examinons quelques exemples d’affectation de noms de fichiers dynamiques.

• Ajoutez la date à un nom de fichier : @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
• Ajoutez DateTime dans le fuseau horaire du client : @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
• Ajout de l’heure du déclencheur : @concat('Test_', pipeline().TriggerTime)
• Sortie d’un nom de fichier personnalisé dans un flux de données de mappage lors de la sortie dans un fichier unique avec la date : 'Test_' + toString(currentDate()) + '.csv'

Dans les cas ci-dessus, quatre noms de fichiers dynamiques sont créés à partir de Test_.

Éditeur de contenu dynamique

L’éditeur de contenu dynamique échappe automatiquement les caractères dans votre contenu lorsque vous avez terminé la modification. Par exemple, le contenu suivant dans l’éditeur de contenu est une interpolation de chaîne avec une fonction d’expression.

"@{toUpper('myData')}"

L’éditeur de contenu dynamique convertit le contenu ci-dessus en expression "@{toUpper('myData')}". Le résultat de cette expression est la chaîne mise en forme ci-dessous.

"MYDATA"

Remplacement de caractères spéciaux

L’éditeur de contenu dynamique échappe automatiquement des caractères tels que des guillemets doubles, barre oblique inverse dans votre contenu lorsque vous terminez la modification. Cela provoque des problèmes si vous souhaitez remplacer le flux de ligne ou l’onglet à l’aide de\n, \t in replace(). Vous pouvez modifier votre contenu dynamique en mode code pour supprimer l’extra \ dans l’expression, ou vous pouvez suivre les étapes ci-dessous pour remplacer des caractères spéciaux à l’aide du langage d’expression :

1. Encodage d’URL par rapport à la valeur de chaîne d’origine
2. Remplacez la chaîne encodée d’URL, par exemple, le flux de ligne (%0A), le retour chariot(%0D), l’onglet horizontal(%09).
3. Décodage d’URL

Par exemple, variable companyName avec un caractère de nouvelle ligne dans sa valeur, l’expression @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) peut supprimer le caractère newline.

Contoso- Corporation

Échappement d’un caractère de guillemet unique

Les fonctions d’expression utilisent un guillemet unique pour les paramètres de valeur de chaîne. Utilisez deux guillemets simples pour échapper un ' caractère dans les fonctions de chaîne. Par exemple, l’expression @concat('Baba', '''s ', 'book store') retourne le résultat ci-dessous.

Baba's book store

Variables d’étendue de pipeline

Ces variables système peuvent être référencées n’importe où dans le pipeline.

Functions

Vous pouvez appeler des fonctions dans des expressions. Les sections suivantes fournissent des informations sur les fonctions qui peuvent être utilisées dans une expression.

Fonctions de date

Fonctions de chaîne

Pour utiliser des chaînes, vous pouvez utiliser ces fonctions de chaîne et certaines fonctions de collection. Les fonctions de chaîne fonctionnent uniquement sur les chaînes.

Fonctions de collection

Pour utiliser des collections, généralement des tableaux, des chaînes et parfois des dictionnaires, vous pouvez utiliser ces fonctions de collection.

Fonctions logiques

Ces fonctions sont utiles dans des conditions, elles peuvent être utilisées pour évaluer n’importe quel type de logique.

Fonctions de conversion

Ces fonctions sont utilisées pour effectuer une conversion entre chacun des types natifs dans la langue :

• ficelle
• entier
• flotter
• boolean
• Tableaux
• Dictionnaires

Fonctions mathématiques

Ces fonctions peuvent être utilisées pour les deux types de nombres : entiers et floats.

Informations de référence sur les fonctions

Cette section répertorie toutes les fonctions disponibles dans l’ordre alphabétique.

ajouter

Retournez le résultat de l’ajout de deux nombres.

add(<summand_1>, <summand_2>)

Exemple

Cet exemple ajoute les nombres spécifiés :

add(1, 1.5)

Retourne ce résultat : 2.5

addDays

Ajoutez un nombre de jours à un horodatage.

addDays('<timestamp>', <days>, '<format>'?)

Exemple 1

Cet exemple ajoute 10 jours à l’horodatage spécifié :

addDays('2018-03-15T13:00:00Z', 10)

Retourne ce résultat : "2018-03-25T00:00:0000000Z"

Exemple 2

Cet exemple soustrait cinq jours de l’horodatage spécifié :

addDays('2018-03-15T00:00:00Z', -5)

Retourne ce résultat : "2018-03-10T00:00:0000000Z"

addHours

Ajoutez un nombre d’heures à un horodatage.

addHours('<timestamp>', <hours>, '<format>'?)

Exemple 1

Cet exemple ajoute 10 heures à l’horodatage spécifié :

addHours('2018-03-15T00:00:00Z', 10)

Retourne ce résultat : "2018-03-15T10:00:0000000Z"

Exemple 2

Cet exemple soustrait cinq heures de l’horodatage spécifié :

addHours('2018-03-15T15:00:00Z', -5)

Retourne ce résultat : "2018-03-15T10:00:0000000Z"

addMinutes

Ajoutez un nombre de minutes à un horodatage.

addMinutes('<timestamp>', <minutes>, '<format>'?)

Exemple 1

Cet exemple ajoute 10 minutes à l’horodatage spécifié :

addMinutes('2018-03-15T00:10:00Z', 10)

Retourne ce résultat : "2018-03-15T00:20:00.0000000Z"

Exemple 2

Cet exemple soustrait cinq minutes de l’horodatage spécifié :

addMinutes('2018-03-15T00:20:00Z', -5)

Retourne ce résultat : "2018-03-15T00:15:00.0000000Z"

addSeconds

Ajoutez un nombre de secondes à un horodatage.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Exemple 1

Cet exemple ajoute 10 secondes à l’horodatage spécifié :

addSeconds('2018-03-15T00:00:00Z', 10)

Retourne ce résultat : "2018-03-15T00:00:10.0000000Z"

Exemple 2

Cet exemple soustrait cinq secondes à l’horodatage spécifié :

addSeconds('2018-03-15T00:00:30Z', -5)

Retourne ce résultat : "2018-03-15T00:00:25.0000000Z"

addToTime

Ajoutez un certain nombre d’unités de temps à un horodatage. Voir également getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Exemple 1

Cet exemple ajoute un jour à l’horodatage spécifié :

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

Retourne ce résultat : "2018-01-02T00:00:00.0000000Z"

Exemple 2

Cet exemple ajoute un jour à l’horodatage spécifié :

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

Retourne le résultat à l’aide du format facultatif « D » : "Tuesday, January 2, 2018"

et

Vérifiez si les deux expressions sont vraies. Retourne true lorsque les deux expressions sont vraies ou retournent false quand au moins une expression a la valeur false.

and(<expression1>, <expression2>)

Exemple 1

Ces exemples vérifient si les valeurs booléennes spécifiées sont toutes deux vraies :

and(true, true)
and(false, true)
and(false, false)

Retourne les résultats suivants :

• Premier exemple : les deux expressions sont vraies. Par conséquent, retourne true.
• Deuxième exemple : une expression est false, donc retourne false.
• Troisième exemple : les deux expressions sont false, donc retourne false.

Exemple 2

Ces exemples vérifient si les expressions spécifiées sont toutes deux vraies :

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

Retourne les résultats suivants :

• Premier exemple : les deux expressions sont vraies. Par conséquent, retourne true.
• Deuxième exemple : une expression est false, donc retourne false.
• Troisième exemple : les deux expressions sont false, donc retourne false.

tableau

Retourne un tableau à partir d’une entrée spécifiée unique. Pour plusieurs entrées, consultez createArray().

array('<value>')

Exemple

Cet exemple crée un tableau à partir de la chaîne « hello » :

array('hello')

Retourne ce résultat : ["hello"]

base64

Retourne la version encodée en base64 pour une chaîne.

base64('<value>')

Exemple

Cet exemple convertit la chaîne « hello » en chaîne encodée en base64 :

base64('hello')

Retourne ce résultat : "aGVsbG8="

base64ToBinary

Retourne la version binaire d’une chaîne encodée en base64.

base64ToBinary('<value>')

Exemple

Cet exemple convertit la chaîne encodée en base64 « aGVsbG8= » en chaîne binaire :

base64ToBinary('aGVsbG8=')

Retourne ce résultat :

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Retournez la version de chaîne pour une chaîne encodée en base64, décodant efficacement la chaîne base64. Utilisez cette fonction plutôt que de décoderBase64(). Bien que les deux fonctions fonctionnent de la même façon, base64ToString() il est préférable.

base64ToString('<value>')

Exemple

Cet exemple convertit la chaîne encodée en base64 « aGVsbG8= » en une seule chaîne :

base64ToString('aGVsbG8=')

Retourne ce résultat : "hello"

binaire

Retourne la version binaire d’une chaîne.

binary('<value>')

Exemple

Cet exemple convertit la chaîne « hello » en chaîne binaire :

binary('hello')

Retourne ce résultat :

"0110100001100101011011000110110001101111"

bool

Retourne la version booléenne d’une valeur.

bool(<value>)

Exemple

Ces exemples convertissent les valeurs spécifiées en valeurs booléennes :

bool(1)
bool(0)

Retourne les résultats suivants :

• Premier exemple : true
• Deuxième exemple : false

fusionner

Retourne la première valeur non null d’un ou plusieurs paramètres. Les chaînes vides, les tableaux vides et les objets vides ne sont pas null.

coalesce(<object_1>, <object_2>, ...)

Exemple

Ces exemples retournent la première valeur non null des valeurs spécifiées ou null lorsque toutes les valeurs sont null :

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

Retourne les résultats suivants :

• Premier exemple : true
• Deuxième exemple : "hello"
• Troisième exemple : null

concat

Combinez deux chaînes ou plus et retournez la chaîne combinée.

concat('<text1>', '<text2>', ...)

Exemple

Cet exemple combine les chaînes « Hello » et « World » :

concat('Hello', 'World')

Retourne ce résultat : "HelloWorld"

contient

Vérifiez si une collection a un élément spécifique. Retourne la valeur true lorsque l’élément est trouvé ou retourne la valeur false lorsqu’il est introuvable. Cette fonction respecte la casse.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

Plus précisément, cette fonction fonctionne sur ces types de collection :

• Chaîne permettant de rechercher une sous-chaîne
• Tableau pour rechercher une valeur
• Dictionnaire pour rechercher une clé

Exemple 1

Cet exemple vérifie la chaîne « hello world » pour la sous-chaîne « world » et retourne true :

contains('hello world', 'world')

Exemple 2

Cet exemple vérifie la chaîne « hello world » pour la sous-chaîne « univers » et retourne false :

contains('hello world', 'universe')

convertFromUtc

Convertissez un horodatage de temps universel coordonné (UTC) en fuseau horaire cible.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Exemple 1

Cet exemple convertit un horodatage en fuseau horaire spécifié :

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

Retourne ce résultat : "2018-01-01T00:00:00Z"

Exemple 2

Cet exemple convertit un horodatage au fuseau horaire et au format spécifiés :

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

Retourne ce résultat : "Monday, January 1, 2018"

convertTimeZone

Convertissez un horodatage du fuseau horaire source vers le fuseau horaire cible.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Exemple 1

Cet exemple convertit le fuseau horaire source en fuseau horaire cible :

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

Retourne ce résultat : "2018-01-01T00:00:00.0000000"

Exemple 2

Cet exemple convertit un fuseau horaire au fuseau horaire et au format spécifiés :

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

Retourne ce résultat : "Monday, January 1, 2018"

convertToUtc

Convertissez un horodatage du fuseau horaire source en temps universel coordonné (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Exemple 1

Cet exemple convertit un horodatage en UTC :

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

Retourne ce résultat : "2018-01-01T08:00:00.0000000Z"

Exemple 2

Cet exemple convertit un horodatage en UTC :

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

Retourne ce résultat : "Monday, January 1, 2018"

createArray

Retourne un tableau à partir de plusieurs entrées. Pour les tableaux d’entrée uniques, consultez array().

createArray('<object1>', '<object2>', ...)

Exemple

Cet exemple crée un tableau à partir de ces entrées :

createArray('h', 'e', 'l', 'l', 'o')

Retourne ce résultat : ["h", "e", "l", "l", "o"]

dataUri

Retourne un URI (Uniform Resource Identifier) de données pour une chaîne.

dataUri('<value>')

Exemple

Cet exemple crée un URI de données pour la chaîne « hello » :

dataUri('hello')

Retourne ce résultat : "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Retournez la version binaire d’un URI (Uniform Resource Identifier) de données. Utilisez cette fonction plutôt que de décoderDataUri(). Bien que les deux fonctions fonctionnent de la même façon, dataUriBinary() il est préférable.

dataUriToBinary('<value>')

Exemple

Cet exemple crée une version binaire pour cet URI de données :

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Retourne ce résultat :

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Retourne la version de chaîne d’un URI (Uniform Resource Identifier) de données.

dataUriToString('<value>')

Exemple

Cet exemple crée une chaîne pour cet URI de données :

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Retourne ce résultat : "hello"

dayOfMonth

Retourne le jour du mois à partir d’un horodatage.

dayOfMonth('<timestamp>')

Exemple

Cet exemple retourne le nombre du jour du mois à partir de cet horodatage :

dayOfMonth('2018-03-15T13:27:36Z')

Retourne ce résultat : 15

jourDeLaSemaine

Retournez le jour de la semaine à partir d’un horodatage.

dayOfWeek('<timestamp>')

Exemple

Cet exemple retourne le nombre du jour de la semaine à partir de cet horodatage :

dayOfWeek('2018-03-15T13:27:36Z')

Retourne ce résultat : 3

dayOfYear

Retournez le jour de l’année à partir d’un horodatage.

dayOfYear('<timestamp>')

Exemple

Cet exemple retourne le nombre du jour de l’année à partir de cet horodatage :

dayOfYear('2018-03-15T13:27:36Z')

Retourne ce résultat : 74

decodeBase64

Retournez la version de chaîne pour une chaîne encodée en base64, décodant efficacement la chaîne base64. Envisagez d’utiliser base64ToString() plutôt que decodeBase64(). Bien que les deux fonctions fonctionnent de la même façon, base64ToString() il est préférable.

decodeBase64('<value>')

Exemple

Cet exemple crée une chaîne pour une chaîne encodée en base64 :

decodeBase64('aGVsbG8=')

Retourne ce résultat : "hello"

decodeDataUri

Retournez la version binaire d’un URI (Uniform Resource Identifier) de données. Envisagez d’utiliser dataUriToBinary(), plutôt que decodeDataUri(). Bien que les deux fonctions fonctionnent de la même façon, dataUriToBinary() il est préférable.

decodeDataUri('<value>')

Exemple

Cet exemple retourne la version binaire de cet URI de données :

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Retourne ce résultat :

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Retourne une chaîne qui remplace les caractères d’échappement par des versions décodées.

decodeUriComponent('<value>')

Exemple

Cet exemple remplace les caractères d’échappement de cette chaîne par des versions décodées :

decodeUriComponent('http%3A%2F%2Fcontoso.com')

Retourne ce résultat : "https://contoso.com"

div

Retourne le résultat entier de la division de deux nombres. Pour obtenir le résultat restant, consultez mod().

div(<dividend>, <divisor>)

Exemple

Les deux exemples divisent le premier nombre par le deuxième nombre :

div(10, 5)
div(11, 5)

Et retournez ce résultat : 2

encodeUriComponent

Retourne une version encodée d’URI (Uniform Resource Identifier) pour une chaîne en remplaçant les caractères non sécurisés par l’URL par les caractères d’échappement. Envisagez d’utiliser uriComponent(), plutôt que encodeUriComponent(). Bien que les deux fonctions fonctionnent de la même façon, uriComponent() il est préférable.

encodeUriComponent('<value>')

Exemple

Cet exemple crée une version encodée par URI pour cette chaîne :

encodeUriComponent('https://contoso.com')

Retourne ce résultat : "http%3A%2F%2Fcontoso.com"

vide

Vérifiez si une collection est vide. Retourne la valeur true lorsque la collection est vide ou retourne la valeur false lorsqu’elle n’est pas vide.

empty('<collection>')
empty([<collection>])

Exemple

Ces exemples vérifient si les collections spécifiées sont vides :

empty('')
empty('abc')

Retourne les résultats suivants :

• Premier exemple : Transmet une chaîne vide, de sorte que la fonction retourne true.
• Deuxième exemple : Transmet la chaîne « abc », donc la fonction retourne false.

endsWith

Vérifiez si une chaîne se termine par une sous-chaîne spécifique. Retourne la valeur true lorsque la sous-chaîne est trouvée ou retourne la valeur false lorsqu’elle est introuvable. Cette fonction n’est pas sensible à la casse.

endsWith('<text>', '<searchText>')

Exemple 1

Cet exemple vérifie si la chaîne « hello world » se termine par la chaîne « world » :

endsWith('hello world', 'world')

Retourne ce résultat : true

Exemple 2

Cet exemple vérifie si la chaîne « hello world » se termine par la chaîne « univers » :

endsWith('hello world', 'universe')

Retourne ce résultat : false

equals

Vérifiez si les deux valeurs, expressions ou objets sont équivalents. Retourne true lorsque les deux sont équivalents ou retournent false lorsqu’ils ne sont pas équivalents.

equals('<object1>', '<object2>')

Exemple

Ces exemples vérifient si les entrées spécifiées sont équivalentes.

equals(true, 1)
equals('abc', 'abcd')

Retourne les résultats suivants :

• Premier exemple : les deux valeurs sont équivalentes, de sorte que la fonction retourne true.
• Deuxième exemple : les deux valeurs ne sont pas équivalentes. Par conséquent, la fonction retourne false.

premier

Retourne le premier élément d’une chaîne ou d’un tableau.

first('<collection>')
first([<collection>])

Exemple

Ces exemples recherchent le premier élément de ces collections :

first('hello')
first(createArray(0, 1, 2))

Et retournez ces résultats :

• Premier exemple : "h"
• Deuxième exemple : 0

flotter

Convertissez une version de chaîne pour un nombre à virgule flottante en nombre à virgule flottante réelle.

float('<value>')

Exemple

Cet exemple crée une version de chaîne pour ce nombre à virgule flottante :

float('10.333')

Retourne ce résultat : 10.333

formatDateTime

Retourne un horodatage au format spécifié.

formatDateTime('<timestamp>', '<format>'?)

Exemple

Cet exemple convertit un horodatage au format spécifié :

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

Retourne ce résultat : "2018-03-15T12:00:00"

getFutureTime

Retourne l’horodatage actuel ainsi que les unités de temps spécifiées.

getFutureTime(<interval>, <timeUnit>, <format>?)

Exemple 1

Supposons que l’horodatage actuel est « 2018-03-01T00:00:00.0000000Z ». Cet exemple ajoute cinq jours à cet horodatage :

getFutureTime(5, 'Day')

Retourne ce résultat : "2018-03-06T00:00:00.0000000Z"

Exemple 2

Supposons que l’horodatage actuel est « 2018-03-01T00:00:00.0000000Z ». Cet exemple ajoute cinq jours et convertit le résultat au format « D » :

getFutureTime(5, 'Day', 'D')

Retourne ce résultat : "Tuesday, March 6, 2018"

getPastTime

Retourne l’horodatage actuel moins les unités de temps spécifiées.

getPastTime(<interval>, <timeUnit>, <format>?)

Exemple 1

Supposons que l’horodatage actuel est « 2018-02-01T00:00:00.0000000Z ». Cet exemple soustrait cinq jours de cet horodatage :

getPastTime(5, 'Day')

Retourne ce résultat : "2018-01-27T00:00:00.0000000Z"

Exemple 2

Supposons que l’horodatage actuel est « 2018-02-01T00:00:00.0000000Z ». Cet exemple soustrait cinq jours et convertit le résultat au format « D » :

getPastTime(5, 'Day', 'D')

Retourne ce résultat : "Saturday, January 27, 2018"

Plus

Vérifiez si la première valeur est supérieure à la deuxième valeur. Retourne la valeur true lorsque la première valeur est supérieure ou retourne la valeur false lorsque la valeur est inférieure.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Exemple

Ces exemples vérifient si la première valeur est supérieure à la deuxième valeur :

greater(10, 5)
greater('apple', 'banana')

Et retournez ces résultats :

• Premier exemple : true
• Deuxième exemple : false

greaterOrEquals

Vérifiez si la première valeur est supérieure ou égale à la deuxième valeur. Retourne la valeur true lorsque la première valeur est supérieure ou égale, ou retourne la valeur false lorsque la première valeur est inférieure.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Exemple

Ces exemples vérifient si la première valeur est supérieure ou égale à la deuxième valeur :

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

Et retournez ces résultats :

• Premier exemple : true
• Deuxième exemple : false

Guid

Générez un identificateur global unique (GUID) en tant que chaîne, par exemple « c2ecc88d-88c8-4096-912c-d6f2e2b138ce » :

guid()

En outre, vous pouvez spécifier un format différent du GUID autre que le format par défaut , « D », qui est de 32 chiffres séparés par des traits d’union.

guid('<format>')

Exemple

Cet exemple génère le même GUID, mais sous la forme de 32 chiffres, séparés par des traits d’union et placés entre parenthèses :

guid('P')

Retourne ce résultat : "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Vérifiez si une expression a la valeur true ou false. En fonction du résultat, retournez une valeur spécifiée.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Exemple

Cet exemple retourne "yes" , car l’expression spécifiée retourne true. Sinon, l’exemple retourne "no":

if(equals(1, 1), 'yes', 'no')

indexOf

Retourne la position de départ ou la valeur d’index d’une sous-chaîne. Cette fonction n’est pas sensible à la casse et les index commencent par le nombre 0.

indexOf('<text>', '<searchText>')

Exemple

Cet exemple recherche la valeur d’index de départ de la sous-chaîne « world » dans la chaîne « hello world » :

indexOf('hello world', 'world')

Retourne ce résultat : 6

int

Retourne la version entière d’une chaîne.

int('<value>')

Exemple

Cet exemple crée une version entière pour la chaîne « 10 » :

int('10')

Retourne ce résultat : 10

json

Retourne la valeur ou l’objet de type JavaScript Object Notation (JSON) pour une chaîne ou un xml.

json('<value>')

Exemple 1

Cet exemple convertit cette chaîne en valeur JSON :

json('[1, 2, 3]')

Retourne ce résultat : [1, 2, 3]

Exemple 2

Cet exemple convertit cette chaîne en JSON :

json('{"fullName": "Sophia Owen"}')

Retourne ce résultat :

{
  "fullName": "Sophia Owen"
}

Exemple 3

Cet exemple convertit ce code XML en JSON :

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

Retourne ce résultat :

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

carrefour

Retourne une collection qui contient uniquement les éléments communs dans les collections spécifiées. Pour apparaître dans le résultat, un élément doit apparaître dans toutes les collections passées à cette fonction. Si un ou plusieurs éléments ont le même nom, le dernier élément portant ce nom apparaît dans le résultat.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Exemple

Cet exemple recherche les éléments courants dans ces tableaux :

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

Retourne un tableau avec uniquement ces éléments : [1, 2]

joindre

Retourne une chaîne qui a tous les éléments d’un tableau et a chaque caractère séparé par un délimiteur.

join([<collection>], '<delimiter>')

Exemple

Cet exemple crée une chaîne à partir de tous les éléments de ce tableau avec le caractère spécifié comme délimiteur :

join(createArray('a', 'b', 'c'), '.')

Retourne ce résultat : "a.b.c"

dernier

Retourne le dernier élément d’une collection.

last('<collection>')
last([<collection>])

Exemple

Ces exemples recherchent le dernier élément de ces collections :

last('abcd')
last(createArray(0, 1, 2, 3))

Retourne les résultats suivants :

• Premier exemple : "d"
• Deuxième exemple : 3

lastIndexOf

Retourne la position de départ ou la valeur d’index pour la dernière occurrence d’une sous-chaîne. Cette fonction n’est pas sensible à la casse et les index commencent par le nombre 0.

lastIndexOf('<text>', '<searchText>')

Exemple

Cet exemple recherche la valeur d’index de départ pour la dernière occurrence de la sous-chaîne « world » dans la chaîne « hello world » :

lastIndexOf('hello world', 'world')

Retourne ce résultat : 6

length

Retourne le nombre d’éléments d’une collection.

length('<collection>')
length([<collection>])

Exemple

Ces exemples comptent le nombre d’éléments de ces collections :

length('abcd')
length(createArray(0, 1, 2, 3))

Et retournez ce résultat : 4

moins

Vérifiez si la première valeur est inférieure à la deuxième valeur. Retourne la valeur true lorsque la première valeur est inférieure ou retourne la valeur false lorsque la première valeur est plus élevée.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Exemple

Ces exemples vérifient si la première valeur est inférieure à la deuxième valeur.

less(5, 10)
less('banana', 'apple')

Et retournez ces résultats :

• Premier exemple : true
• Deuxième exemple : false

lessOrEquals

Vérifiez si la première valeur est inférieure ou égale à la deuxième valeur. Retourne la valeur true lorsque la première valeur est inférieure ou égale, ou retourne la valeur false lorsque la première valeur est supérieure.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Exemple

Ces exemples vérifient si la première valeur est inférieure ou égale à la deuxième valeur.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

Et retournez ces résultats :

• Premier exemple : true
• Deuxième exemple : false

max

Retourne la valeur la plus élevée d’une liste ou d’un tableau avec des nombres inclus aux deux extrémités.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Exemple

Ces exemples obtiennent la valeur la plus élevée à partir de l’ensemble de nombres et du tableau :

max(1, 2, 3)
max(createArray(1, 2, 3))

Et retournez ce résultat : 3

min

Retourne la valeur la plus basse d’un ensemble de nombres ou d’un tableau.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Exemple

Ces exemples obtiennent la valeur la plus basse dans l’ensemble de nombres et le tableau :

min(1, 2, 3)
min(createArray(1, 2, 3))

Et retournez ce résultat : 1

mod

Retournez le reste de la division de deux nombres. Pour obtenir le résultat entier, consultez div().

mod(<dividend>, <divisor>)

Exemple

Cet exemple divise le premier nombre par le deuxième nombre :

mod(3, 2)

Et retournez ce résultat : 1

mul

Retournez le produit en multipliant deux nombres.

mul(<multiplicand1>, <multiplicand2>)

Exemple

Ces exemples multiplent le premier nombre par le deuxième nombre :

mul(1, 2)
mul(1.5, 2)

Et retournez ces résultats :

• Premier exemple : 2
• Deuxième exemple 3

not

Vérifiez si une expression est false. Retourne la valeur true lorsque l’expression est false ou retourne false lorsque la valeur est true.

not(<expression>)

Exemple 1

Ces exemples vérifient si les expressions spécifiées sont false :

not(false)
not(true)

Et retournez ces résultats :

• Premier exemple : l’expression est false, donc la fonction retourne true.
• Deuxième exemple : l’expression est vraie, donc la fonction retourne false.

Exemple 2

Ces exemples vérifient si les expressions spécifiées sont false :

not(equals(1, 2))
not(equals(1, 1))

Et retournez ces résultats :

• Premier exemple : l’expression est false, donc la fonction retourne true.
• Deuxième exemple : l’expression est vraie, donc la fonction retourne false.

ou

Vérifiez si au moins une expression est vraie. Retourne true quand au moins une expression a la valeur true ou retourne false lorsque les deux sont false.

or(<expression1>, <expression2>)

Exemple 1

Ces exemples vérifient si au moins une expression est vraie :

or(true, false)
or(false, false)

Et retournez ces résultats :

• Premier exemple : Au moins une expression est vraie, donc la fonction retourne true.
• Deuxième exemple : les deux expressions sont false, de sorte que la fonction retourne false.

Exemple 2

Ces exemples vérifient si au moins une expression est vraie :

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

Et retournez ces résultats :

• Premier exemple : Au moins une expression est vraie, donc la fonction retourne true.
• Deuxième exemple : les deux expressions sont false, de sorte que la fonction retourne false.

rand

Retourne un entier aléatoire à partir d’une plage spécifiée, qui est inclusive uniquement à la fin de début.

rand(<minValue>, <maxValue>)

Exemple

Cet exemple obtient un entier aléatoire de la plage spécifiée, à l’exception de la valeur maximale :

rand(1, 5)

Retourne l’un de ces nombres comme résultat : 1, , 2, 3ou 4

range

Retourne un tableau entier qui commence à partir d’un entier spécifié.

range(<startIndex>, <count>)

Exemple

Cet exemple crée un tableau d’entiers qui commence à partir de l’index spécifié et a le nombre spécifié d’entiers :

range(1, 4)

Retourne ce résultat : [1, 2, 3, 4]

replace

Remplacez une sous-chaîne par la chaîne spécifiée et retournez la chaîne de résultat. Cette fonction respecte la casse.

replace('<text>', '<oldText>', '<newText>')

Exemple

Cet exemple recherche la sous-chaîne « old » dans « l’ancienne chaîne » et remplace « old » par « new » :

replace('the old string', 'old', 'new')

Retourne ce résultat : "the new string"

skip

Supprimez les éléments du devant d’une collection et renvoyez tous les autres éléments.

skip([<collection>], <count>)

Exemple

Cet exemple supprime un élément, le nombre 0, à partir du devant du tableau spécifié :

skip(createArray(0, 1, 2, 3), 1)

Retourne ce tableau avec les éléments restants : [1,2,3]

fractionner

Retourne un tableau qui contient des sous-chaînes, séparés par des virgules, en fonction du caractère délimiteur spécifié dans la chaîne d’origine.

split('<text>', '<delimiter>')

Exemple

Cet exemple crée un tableau avec des sous-chaînes à partir de la chaîne spécifiée en fonction du caractère spécifié comme délimiteur :

split('a_b_c', '_')

Retourne ce tableau comme résultat : ["a","b","c"]

startOfDay

Retournez le début de la journée pour un horodatage.

startOfDay('<timestamp>', '<format>'?)

Exemple

Cet exemple recherche le début du jour pour cet horodatage :

startOfDay('2018-03-15T13:30:30Z')

Retourne ce résultat : "2018-03-15T00:00:00.0000000Z"

startOfHour

Retournez le début de l’heure pour un horodatage.

startOfHour('<timestamp>', '<format>'?)

Exemple

Cet exemple recherche le début de l’heure pour cet horodatage :

startOfHour('2018-03-15T13:30:30Z')

Retourne ce résultat : "2018-03-15T13:00:00.0000000Z"

startOfMonth

Retournez le début du mois pour un horodatage.

startOfMonth('<timestamp>', '<format>'?)

Exemple

Cet exemple retourne le début du mois pour cet horodatage :

startOfMonth('2018-03-15T13:30:30Z')

Retourne ce résultat : "2018-03-01T00:00:00.0000000Z"

startsWith

Vérifiez si une chaîne commence par une sous-chaîne spécifique. Retourne la valeur true lorsque la sous-chaîne est trouvée ou retourne la valeur false lorsqu’elle est introuvable. Cette fonction n’est pas sensible à la casse.

startsWith('<text>', '<searchText>')

Exemple 1

Cet exemple vérifie si la chaîne « hello world » commence par la sous-chaîne « hello » :

startsWith('hello world', 'hello')

Retourne ce résultat : true

Exemple 2

Cet exemple vérifie si la chaîne « hello world » commence par la sous-chaîne « greetings » :

startsWith('hello world', 'greetings')

Retourne ce résultat : false

ficelle

Retourne la version de chaîne pour une valeur.

string(<value>)

Exemple 1

Cet exemple crée la version de chaîne pour ce nombre :

string(10)

Retourne ce résultat : "10"

Exemple 2

Cet exemple crée une chaîne pour l’objet JSON spécifié et utilise la barre oblique inverse (\) comme caractère d’échappement pour le guillemet double (").

string( { "name": "Sophie Owen" } )

Retourne ce résultat : "{ \\"name\\": \\"Sophie Owen\\" }"

sous

Retourne le résultat de la soustraction du deuxième nombre du premier nombre.

sub(<minuend>, <subtrahend>)

Exemple

Cet exemple soustrait le deuxième nombre du premier nombre :

sub(10.3, .3)

Retourne ce résultat : 10

Sous-chaîne

Retourne des caractères à partir d’une chaîne, en commençant par la position spécifiée ou l’index. Les valeurs d’index commencent par le nombre 0.

substring('<text>', <startIndex>, <length>)

Exemple

Cet exemple crée une sous-chaîne à cinq caractères à partir de la chaîne spécifiée, à partir de la valeur d’index 6 :

substring('hello world', 6, 5)

Retourne ce résultat : "world"

soustractionFromTime

Soustrait un certain nombre d’unités de temps d’un horodatage. Voir aussi getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Exemple 1

Cet exemple soustrait un jour de cet horodatage :

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

Retourne ce résultat : "2018-01-01T00:00:00:0000000Z"

Exemple 2

Cet exemple soustrait un jour de cet horodatage :

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

Retourne ce résultat à l’aide du format facultatif « D » : "Monday, January, 1, 2018"

prendre

Renvoyer des éléments à partir de l’avant d’une collection.

take('<collection>', <count>)
take([<collection>], <count>)

Exemple

Ces exemples obtiennent le nombre spécifié d’éléments à partir de l’avant de ces collections :

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

Et retournez ces résultats :

• Premier exemple : "abc"
• Deuxième exemple : [0, 1, 2]

Tiques

Retourne la valeur de ticks propriété d’un horodatage spécifié. Une graduation est un intervalle de 100 nanosecondes.

ticks('<timestamp>')

toLower

Retourne une chaîne au format minuscule. Si un caractère de la chaîne n’a pas de version minuscule, ce caractère reste inchangé dans la chaîne retournée.

toLower('<text>')

Exemple

Cet exemple convertit cette chaîne en minuscules :

toLower('Hello World')

Retourne ce résultat : "hello world"

toUpper

Retourne une chaîne au format majuscule. Si un caractère de la chaîne n’a pas de version majuscule, ce caractère reste inchangé dans la chaîne retournée.

toUpper('<text>')

Exemple

Cet exemple convertit cette chaîne en majuscules :

toUpper('Hello World')

Retourne ce résultat : "HELLO WORLD"

couper

Supprimez l’espace blanc de début et de fin d’une chaîne et retournez la chaîne mise à jour.

trim('<text>')

Exemple

Cet exemple supprime l’espace blanc de début et de fin de la chaîne « Hello World » :

trim(' Hello World  ')

Retourne ce résultat : "Hello World"

union

Retourne une collection qui contient tous les éléments des collections spécifiées. Pour apparaître dans le résultat, un élément peut apparaître dans n’importe quelle collection passée à cette fonction. Si un ou plusieurs éléments ont le même nom, le dernier élément portant ce nom apparaît dans le résultat.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Exemple

Cet exemple obtient tous les éléments de ces collections :

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

Retourne ce résultat : [1, 2, 3, 10, 101]

uriComponent

Retourne une version encodée d’URI (Uniform Resource Identifier) pour une chaîne en remplaçant les caractères non sécurisés par l’URL par les caractères d’échappement. Utilisez cette fonction plutôt qu’encodeUriComponent(). Bien que les deux fonctions fonctionnent de la même façon, uriComponent() il est préférable.

uriComponent('<value>')

Exemple

Cet exemple crée une version encodée par URI pour cette chaîne :

uriComponent('https://contoso.com')

Retourne ce résultat : "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Retournez la version binaire d’un composant URI (Uniform Resource Identifier).

uriComponentToBinary('<value>')

Exemple

Cet exemple crée la version binaire de cette chaîne encodée par URI :

uriComponentToBinary('http%3A%2F%2Fcontoso.com')

Retourne ce résultat :

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Retourne la version de chaîne pour une chaîne encodée URI (Uniform Resource Identifier), décodant efficacement la chaîne encodée par l’URI.

uriComponentToString('<value>')

Exemple

Cet exemple crée la version de chaîne décodée pour cette chaîne encodée d’URI :

uriComponentToString('http%3A%2F%2Fcontoso.com')

Retourne ce résultat : "https://contoso.com"

utcNow

Retourne l’horodatage actuel.

utcNow('<format>')

Si vous le souhaitez, vous pouvez spécifier un autre format avec le paramètre de <format> .

Exemple 1

Supposons qu’aujourd’hui soit le 15 avril 2018 à 13h00. Cet exemple obtient l’horodatage actuel :

utcNow()

Retourne ce résultat : "2018-04-15T13:00:00.0000000Z"

Exemple 2

Supposons qu’aujourd’hui soit le 15 avril 2018 à 13h00. Cet exemple obtient l’horodatage actuel au format facultatif « D » :

utcNow('D')

Retourne ce résultat : "Sunday, April 15, 2018"

Xml

Retourne la version XML d’une chaîne qui contient un objet JSON.

xml('<value>')

Exemple 1

Cet exemple crée la version XML de cette chaîne, qui contient un objet JSON :

xml(json('{ \"name\": \"Sophia Owen\" }'))

Retourne ce code XML de résultat :

<name>Sophia Owen</name>

Exemple 2

Supposons que vous disposez de cet objet JSON :

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Cet exemple crée du code XML pour une chaîne qui contient cet objet JSON :

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

Retourne ce code XML de résultat :

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

xpath

Recherchez des nœuds ou des valeurs qui correspondent à une expression XPath (XML Path Language) et retournez les nœuds ou valeurs correspondants. Une expression XPath, ou simplement « XPath », vous permet de naviguer dans une structure de document XML afin de pouvoir sélectionner des nœuds ou des valeurs de calcul dans le contenu XML.

xpath('<xml>', '<xpath>')

Exemple 1

Dans l’exemple 1, cet exemple recherche des nœuds qui correspondent au <count></count> nœud et ajoute ces valeurs de nœud à la sum() fonction :

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

Retourne ce résultat : 30

Exemple 2

Pour cet exemple, les deux expressions recherchent des nœuds qui correspondent au <location></location> nœud, dans les arguments spécifiés, qui incluent du code XML avec un espace de noms. Les expressions utilisent le caractère de barre oblique inverse (\) comme caractère d’échappement pour le guillemet double (").

• Expression 1

  xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

• Expression 2

  xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')

Voici les arguments :

• Ce code XML, qui inclut l’espace de noms de document XML, xmlns="http://contoso.com":

  <?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>
  

• L’une ou l’autre expression XPath ici :

  • /*[name()=\"file\"]/*[name()=\"location\"]

  • /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Voici le nœud de résultat qui correspond au <location></location> nœud :

<location xmlns="https://contoso.com">Paris</location>

Exemple 3

Dans l’exemple 3, cet exemple recherche la valeur dans le <location></location> nœud :

xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')

Retourne ce résultat : "Paris"

Contenu connexe

Pour obtenir des instructions sur l’utilisation générale des paramètres, reportez-vous à Parameters for Data Factory in Fabric