Paramètres globaux dans Azure Data Factory

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 paramètres globaux représentent des constantes d’une fabrique de données, qui peuvent être consommées par un pipeline dans n’importe quelle expression. Elles sont utiles quand vous avez plusieurs pipelines avec des valeurs et des noms de paramètres identiques. Lors de la promotion d’une fabrique de données à l’aide du processus d’intégration et de déploiement continus (CI/CD), vous pouvez remplacer ces paramètres dans chaque environnement.

Création de paramètres globaux

Pour créer un paramètre global, accédez à l’onglet Paramètres globaux de la section Gérer. Sélectionnez Nouveau pour ouvrir le volet latéral de navigation.

Screenshot that highlights the New button you select to create global parameters.

Dans le volet latéral de navigation, entrez un nom, sélectionnez un type de données, puis spécifiez la valeur de votre paramètre.

Screenshot that shows where you add the name, data type, and value for the new global parameter.

Après avoir créé un paramètre global, vous pouvez le modifier en cliquant sur le nom du paramètre. Pour modifier plusieurs paramètres à la fois, sélectionnez Modifier tout.

Create global parameters

Utilisation de paramètres globaux dans un pipeline

Les paramètres globaux peuvent être utilisés dans n’importe quelle expression de pipeline. Si un pipeline fait référence à une autre ressource, par exemple un jeu de données ou un workflow, vous pouvez transmettre la valeur de paramètre globale via les paramètres de cette ressource. Les paramètres globaux sont référencés en tant que pipeline().globalParameters.<parameterName>.

Using global parameters

Paramètres globaux dans CI/CD

Nous vous recommandons d’inclure des paramètres globaux dans le modèle ARM pendant la CI/CD. Le nouveau mécanisme d’inclusion de paramètres globaux dans le modèle ARM (à partir de « Gérer le hub » -> « Modèle ARM » –> « Inclure des paramètres globaux dans le modèle ARM ») comme illustré ci-dessous ne sera pas en conflit/remplacera les paramètres d’usine comme il était utilisé précédemment, ce qui n’exige pas de PowerShell supplémentaire pour le déploiement de paramètres globaux pendant le déploiement de la CI/CD.

Screenshot of 'Include in ARM template'.

Remarque

Nous avons déplacé l’expérience de l’interface utilisateur pour inclure des paramètres globaux de la section « Paramètres globaux » vers la section « Modèle ARM » dans le hub de gestion. Si vous utilisez déjà l’ancien mécanisme (à partir de « Gérer le hub » -> « Paramètres globaux » –> « Inclure dans le modèle ARM »), vous pouvez continuer. Nous continuerons de le prendre en charge.

Si vous utilisez l’ancien flux d’intégration de paramètres globaux dans votre solution d’intégration et de déploiement continus, il continuera de fonctionner :

  • Inclure les paramètres globaux dans le modèle ARM (depuis « Gérer le hub » -> « Paramètres globaux » -> « Inclure dans le modèle ARM ») Screenshot of deprecated 'Include in ARM template'.

  • Déployer des paramètres globaux via un script PowerShell

Nous vous recommandons vivement d’utiliser le nouveau mécanisme d’inclusion de paramètres globaux dans le modèle ARM (à partir de « Gérer le hub » -> « Modèle ARM » –> « Inclure des paramètres globaux dans un modèle ARM ») car il restitue le CICD avec des paramètres globaux beaucoup plus simples et plus faciles à gérer.

Notes

Remarque : la configuration Inclure les paramètres globaux dans le modèle ARM est uniquement disponible en « mode Git ». Actuellement, elle est désactivée en mode « en mode direct » ou en mode « Data Factory ».

Avertissement

Vous ne pouvez pas utiliser « - » dans le nom du paramètre. Vous recevrez un code d’erreur « {"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is not valid: .....} ». Toutefois, vous pouvez utiliser le caractère « _ » dans le nom du paramètre.