Configurer les paramètres d’un travail
Cet article décrit la fonctionnalité des paramètres de projet et la configuration des paramètres de projet avec l’IU de l’espace de travail Databricks. Vous pouvez également ajouter des paramètres de projet aux définitions JSON et YAML utilisées avec l’API REST, CLI et les DAB. Consultez API de projets, Qu’est-ce que la CLI de Databricks ?, et Quels sont les regroupements de ressources Databricks ?
Quels sont les paramètres de projet ?
Les paramètres de projet sont des paires clé-valeur qui permettent de paramétrer des projets avec des valeurs statiques ou dynamiques par défaut. Vous pouvez éventuellement remplacer les paramètres configurés dans un projet lorsque vous déclenchez une nouvelle exécution. Consultez Exécuter un projet avec différents paramètres.
Les clés de paramètre de projet ne peuvent contenir que _ - . ou des caractères alphanumériques. Les valeurs de paramètre sont définies comme des chaînes ou références de valeurs dynamiques. Consulter Qu’est-ce qu’une référence de valeur dynamique ?
Remarque
Vous pouvez utiliser n’importe quel JSON valide comme valeur de paramètre. Par exemple, le type de tâche For each peut analyser des listes comme les suivantes :
[1, 2, 3]
['a', 'b', 'c']
Ajouter ou modifier des paramètres de projet
Utilisez la boîte de dialogue Paramètres de projet pour ajouter de nouveaux paramètres, modifier des clés et des valeurs de paramètres existantes ou supprimer des paramètres.
Pour modifier les paramètres avec l’IU de l’espace de travail, sélectionnez un projet existant en procédant comme suit :
- Cliquez sur
Workflows dans la barre latérale. - Dans la colonne Nom, cliquez sur le nom d’un travail.
- Dans la barre latérale Détails du projet, cliquez sur Modifier les paramètres. La boîte de dialogue Paramètres de projet s’affiche.
- Ajoutez ou modifiez des paramètres à l’aide des champs Clé et Valeur.
- Cliquez sur
pour supprimer un paramètre. - Cliquez sur Enregistrer pour enregistrer les changements.
Remarque
Cliquez sur { } pour répertorier les références de valeurs dynamiques disponibles. Sélectionnez une option dans la liste pour l’insérer dans le champ Valeur.
Pushdown du paramètre de projet
Les paramètres de projet sont automatiquement envoyés comme paramètres clé-valeur à toutes les tâches qui prennent en charge des paramètres clé-valeur. Ces paramètres incluent les types de tâches suivants :
- Notebook
- Wheel Python (uniquement lorsqu’elle est configurée avec des arguments de mot clé)
- Requête SQL, tableau de bord hérité ou fichier
- Exécuter le projet
Les paramètres de projet transmis aux tâches sont visibles dans la configuration de la tâche dans l’IU, près des paramètres de tâche configurés.
Important
Les paramètres de tâche sont prioritaires sur les paramètres de tâche. Si un paramètre de travail et un paramètre de tâche ont la même clé, le paramètre de travail remplace le paramètre de tâche.
Références de valeurs dynamiques aux paramètres de projet
Toutes les tâches qui prennent en charge des références de valeurs dynamiques peuvent accéder aux paramètres de projet.
Utilisez la référence {{job.parameters.<name>}} de valeur dynamique, en remplaçant <name> par key qui identifie le paramètre.
Exécuter un travail avec des paramètres différents
Vous pouvez remplacer les paramètres de projet configurés ou en ajouter de nouveaux lorsque vous exécutez un projet avec des paramètres différents. Consultez Exécuter un projet avec différents paramètres.
Vous pouvez également remplacer les paramètres de projet lors de la réparation d’une exécution de projet. Consultez la section Réexécuter les tâches ayant échoué et ignorées.