Création d'expressions

Dernière mise à jour : 27/10/2026

Utilisez des expressions pour calculer les valeurs des colonnes ou définir des conditions lors de l'ajout de colonnes, de la modification des expressions de colonne, de la création de règles de transformation ou du filtrage de jeux de données.

Le générateur d'expression répertorie les éléments disponibles pour la tâche en cours. Les références aux tâches de déplacement couvrent les tâches de dépôt temporaire gérées par SaaS, de dépôt temporaire dans un lac et de réplication. Les expressions de stockage, de transformation et de datamart dépendent de la plateforme de données ou du moteur de tâches. Pour les fonctions de transformation de flux et de stockage CDC, consultez Fonctions de transformation. Utilisez les fonctions et la syntaxe disponibles dans votre éditeur.

Création ou modification d'une expression

1. Ouvrez le générateur d'expression depuis la colonne, la règle de transformation ou le filtre de jeu de données que vous êtes en train de configurer.

   Pour une expression de colonne, cliquez sur sur la colonne.

2. Sélectionnez un élément, puis cliquez sur pour l'insérer.

   Vous pouvez également saisir l'expression. Insérez des paramètres de colonne pour fournir des valeurs à partir de chaque ligne source, en conservant la syntaxe utilisée par votre éditeur.

   Pour insérer un opérateur depuis la barre d'outils, cliquez à l'endroit où il doit se trouver dans l'expression, puis cliquez sur l'opérateur.

3. Remplacez les espaces réservés des arguments de fonction par des paramètres de colonne, des constantes ou des expressions imbriquées.

   Mettez les constantes de texte et de date entre guillemets simples, par exemple 'Unknown' et '2026-10-08'. Représentez un guillemet imbriqué à l'aide de deux guillemets : 'O''Brien'. Saisissez les nombres sans guillemets, par exemple 12 ou 12.5. Utilisez NULL pour une valeur manquante et non le texte 'NULL'.

4. Testez l'expression comme décrit ci-dessous, puis cliquez sur OK pour l'enregistrer.

Utilisation d'éléments d'expression

• Colonnes : les colonnes du jeu de données source fournissent des valeurs provenant de la ligne en cours de traitement.

  Pour les tâches de transformation de flux, cette liste inclut également des colonnes de dépôt temporaire telles que hdr__kafka_partition et hdr__file_name, dans l'ordre de la source. Celles-ci sont distinctes des en-têtes Q_H_ dans les expressions de tâche de déplacement. Consultez Les tables de dépôt temporaire..

• Fonctions : calculez ou convertissez des valeurs. Fournissez les arguments dans l'ordre indiqué par la signature des fonctions. Consultez Fonctions d'expression.

  Note InformationsPour les expressions Azure Synapse Analytics, $RTRIM et $LTRIM suppriment uniquement les espaces, quel que soit le caractère de suppression spécifié.

• Opérateurs : combinez des valeurs, comparez-les ou définissez des conditions. Utilisez des parenthèses pour contrôler l'ordre d'évaluation. Consultez Opérateurs d'expression.

• En-têtes : utilisez des métadonnées de modification dans les tâches de dépôt temporaire gérées par SaaS, de dépôt temporaire dans un lac et de réplication. Consultez En-têtes d'expression pour l'applicabilité des points de terminaison sources et les valeurs de phase de traitement.

Exemple : Combinaison de valeurs de colonne

L'expression suivante joint first_file_name et first_file_title à l'aide de deux-points :

${first_file_name} || ':' || ${first_file_title}

Pour les valeurs d'échantillon sales et Sales June 2022, le résultat est sales:Sales June 2022.

Test d'expressions

Utilisez des valeurs de paramètres d'échantillon pour vérifier le résultat calculé avant d'enregistrer. L'extraction de paramètres identifie les entrées d'expression ; le test évalue l'expression avec les valeurs que vous fournissez.

1. Cliquez sur Extraire les paramètres.

2. Saisissez une Valeur à tester pour chaque paramètre, en utilisant des valeurs appropriées pour le type de données de la colonne.

3. Cliquez sur Tester l'expression et vérifiez le résultat.

Si l'expression n'est pas valide, corrigez sa syntaxe et ses arguments, puis extrayez de nouveau les paramètres avant de la retester. Répétez avec des valeurs représentatives, y compris des valeurs manquantes, le cas échéant. Un test d'échantillon réussi ne vérifie pas chaque ligne source.