Configurer les paramètres du job
Configurez les parameters du Job dans l’interface utilisateur du Workspace Databricks, ou ajoutez-les aux définitions JSON et YAML utilisées avec l’API REST, la CLI et les Declarative Automation Bundles. Voir API Jobs, CLI Databricks et Que sont les Declarative Automation Bundles ?.
Que sont les paramètres de job ?
Les paramètres de Job sont des paires clé-valeur qui vous permettent de paramétrer des Jobs avec des valeurs statiques ou dynamiques default. Vous pouvez éventuellement remplacer les parameters configurés dans un Job lors du Trigger d'une nouvelle exécution. Consultez Exécuter un Job avec différents parameters.
Les clés de parameter de Job ne peuvent contenir que _ - . ou des caractères alphanumériques. Les valeurs de parameter sont définies comme des chaînes de caractères ou des références de valeur dynamique. Consultez les références de valeurs dynamiques.
Une valeur de paramètre de job peut être n'importe quel JSON valide, y compris des tableaux. Pour savoir comment les tâches consomment les paramètres de tableau JSON, consultez Configurer les paramètres de tâche.
Ajouter ou modifier des paramètres de job
Utilisez la boîte de dialogue Paramètres de job pour ajouter de nouveaux paramètres, modifier les clés et les valeurs de paramètres existants, ou supprimer des paramètres.
Pour modifier les paramètres avec l'interface utilisateur du Workspace, sélectionnez un job existant en suivant les étapes suivantes :
- Dans la barre latérale de votre workspace Databricks, cliquez sur Tâches & Pipelines .
- Facultativement, sélectionnez les filtres **Jobs** et **Appartenant à moi**.
- Cliquez sur le **Link** **Nom** de votre Job.
- Dans la barre latérale **Détails du job**, cliquez sur **Modifier les paramètres**. La boîte de dialogue **Paramètres du job** apparaît.
- Ajoutez ou modifiez les paramètres à l'aide des champs **Clé** et **Valeur**.
- Cliquez sur l'icône
pour supprimer un paramètre. - Cliquez sur « Enregistrer » pour appliquer vos modifications.
Cliquez sur { } pour afficher les références de valeurs dynamiques disponibles. Sélectionnez une option dans la liste pour l'insérer dans le champ Valeur .
Pushdown de paramètres de job
Les paramètres de Job sont transférés à différents types de tâches de différentes manières. Pour comprendre comment ils sont transmis et comment y accéder dans la tâche, voir Accéder aux valeurs des paramètres à partir d’une tâche.
Pour les tâches qui acceptent des paramètres clé-valeur, les paramètres de job sont transférés automatiquement, et si un paramètre de job et un paramètre de tâche partagent une clé, le paramètre de job a la priorité. Les tâches qui acceptent les paramètres de tableau JSON ne reçoivent pas automatiquement les paramètres de Job ; veuillez les référencer explicitement avec {{job.parameters.<name>}}. Consultez Configurer les parameters des tâches.
Exécuter un job avec différents paramètres
Vous pouvez ignorer les paramètres de job configurés ou en ajouter de nouveaux lorsque vous exécutez un job avec des paramètres différents. Consultez Exécuter un job avec des paramètres différents.
Vous pouvez également remplacer les paramètres du job lorsque vous réparez une exécution de job. Voir Réexécuter les tâches échouées et ignorées.