Taakparameters configureren
In dit artikel worden de functionaliteit van taakparameters beschreven en taakparameters geconfigureerd met de gebruikersinterface van de Databricks-werkruimte. U kunt ook taakparameters toevoegen aan JSON- en YAML-definities die worden gebruikt met de REST API, CLI en DABs. Zie jobs-API, wat is de Databricks CLI? en wat zijn Databricks Asset Bundles?
Wat zijn taakparameters?
Taakparameters zijn sleutel-waardeparen waarmee u taken kunt parameteriseren met standaard statische of dynamische waarden. U kunt eventueel parameters overschrijven die zijn geconfigureerd in een taak bij het activeren van een nieuwe uitvoering. Zie Een taak uitvoeren met verschillende parameters.
Taakparametersleutels kunnen alleen alfanumerieke tekens bevatten _ - . . Parameterwaarden worden ingesteld als tekenreeksen of dynamische waardeverwijzingen. Zie Wat is een verwijzing naar dynamische waarden?
Notitie
U kunt elke geldige JSON gebruiken als parameterwaarde. Het taaktype kan bijvoorbeeld For each lijsten parseren, zoals de volgende:
[1, 2, 3]
['a', 'b', 'c']
Taakparameters toevoegen of bewerken
Gebruik het dialoogvenster Taakparameters om nieuwe parameters toe te voegen, bestaande parametersleutels en -waarden te bewerken of parameters te verwijderen.
Als u parameters wilt bewerken met de gebruikersinterface van de werkruimte, selecteert u een bestaande taak met behulp van de volgende stappen:
- Klik op
Werkstromen in de zijbalk. - Klik in de kolom Naam op de taaknaam.
- Klik in de zijbalk Taakdetails op Parameters bewerken. Het dialoogvenster Taakparameters wordt weergegeven.
- Parameters toevoegen of bewerken met behulp van sleutel- en waardevelden.
- Klik op de
parameter om een parameter te verwijderen. - Klik op Opslaan om uw wijzigingen toe te passen.
Notitie
Klik op { } om beschikbare dynamische waardeverwijzingen weer te geven. Selecteer een optie in de lijst om deze in het veld Waarde in te voegen.
Pushdown van taakparameter
Taakparameters worden automatisch naar beneden gepusht als sleutelwaardeparameters voor alle taken die sleutelwaardeparameters accepteren, waaronder de volgende taaktypen:
- Notebook
- Python-wiel (alleen als deze is geconfigureerd met trefwoordargumenten)
- SQL-query, verouderd dashboard of bestand
- Taak uitvoeren
Taakparameters die worden doorgegeven aan taken, zijn zichtbaar in de taakconfiguratie in de gebruikersinterface naast geconfigureerde taakparameters.
Belangrijk
Taakparameters hebben voorrang op taakparameters. Als een taakparameter en een taakparameter dezelfde sleutel hebben, overschrijft de taakparameter de taakparameter.
Dynamische waardeverwijzingen naar taakparameters
Alle taken die dynamische waardeverwijzingen accepteren, hebben toegang tot taakparameters.
Gebruik de verwijzing naar {{job.parameters.<name>}}dynamische waarden en vervang deze door <name> de key parameter die de parameter identificeert.
Een taak uitvoeren met verschillende parameters
U kunt geconfigureerde taakparameters overschrijven of nieuwe parameters toevoegen wanneer u een taak met verschillende parameters uitvoert. Zie Een taak uitvoeren met verschillende parameters.
U kunt ook taakparameters overschrijven wanneer u een taakuitvoering herstelt. Zie Mislukte en overgeslagen taken opnieuw uitvoeren.