Fonctions définies par l’utilisateur dans le 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, l’aide à la décision et la création de rapports. Découvrez comment démarrer un nouvel essai gratuitement !

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.

Une fonction définie par l’utilisateur est une expression personnalisée que vous pouvez définir pour pouvoir réutiliser la logique sur plusieurs flux de données de mappage. Les fonctions définies par l’utilisateur résident dans une collection appelée bibliothèque de flux de données pour pouvoir regrouper facilement des ensembles courants de fonctions personnalisées.

Chaque fois que vous vous retrouvez à développer la même logique dans une expression dans plusieurs flux de données de mappage, il pourrait être utile de créer une fonction définie par l’utilisateur à la place.

Prise en main

Pour commencer à utiliser les fonctions définies par l’utilisateur, vous devez d’abord créer une bibliothèque de flux de données. Accédez à la page de gestion, puis recherchez des bibliothèques de flux de données sous la section de création.

Bibliothèque de flux de données

À partir de cet emplacement, vous pouvez cliquer sur le bouton +Nouveau pour créer une bibliothèque de flux de données. Renseignez le nom et la description. Vous êtes alors prêt à créer votre fonction définie par l’utilisateur.

Nouvelle fonction définie par l’utilisateur

Pour créer une fonction définie par l’utilisateur, à partir de la bibliothèque de flux de données dans laquelle vous souhaitez créer la fonction, cliquez sur le bouton +Nouveau.

Renseignez le nom de votre fonction définie par l’utilisateur.

Notes

Vous ne pouvez pas utiliser le nom d’une expression de flux de données de mappage existante. Pour obtenir la liste des expressions de flux de données de mappage actuelles, consultez Expressions de transformation de données dans le flux de données de mappage | Microsoft Docs

Les fonctions définies par l’utilisateur peuvent comporter plusieurs arguments ou n’en comporter aucun. Les arguments vous permettent de transmettre des valeurs lorsque votre fonction est appelée et de faire référence à ces arguments dans la logique de votre expression. Les arguments sont automatiquement nommés à partir d’i1, i2, etc. et vous pouvez choisir le type de données de l’argument dans la liste déroulante.

Le corps de la fonction définie par l’utilisateur est l’endroit où vous spécifiez la logique de votre fonction. L’éditeur permet d’accéder à l’expérience complète du générateur d’expressions | Microsoft Docs et de référencer vos arguments créés et toutes les expressions de transformation de données dans le flux de données de mappage | Microsoft Docs.

Notes

Une fonction définie par l’utilisateur ne peut pas faire référence à une autre fonction définie par l’utilisateur.

Utilisation d’une fonction définie par l’utilisateur dans le générateur d’expressions

Les fonctions définies par l’utilisateur apparaissent dans le générateur d’expressions de flux de données de mappage sous Fonctions de bibliothèque de flux de données. À partir de cet emplacement, vous pouvez utiliser vos fonctions créées personnalisées et transmettre les arguments appropriés (le cas échéant) que vous avez définis.