Taak parameters configureren
In dit artikel wordt de functionaliteit van taakparameters beschreven en wordt de taak parameters geconfigureerd met de gebruikersinterface van de Databricks-werkruimte. U kunt ook taak-parameters 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 job-parameters?
Taak-parameters zijn sleutel-waardeparen waarmee u taken kunt parameteriseren met standaard statische of dynamische values. U kunt desgewenst parameters geconfigureerd in een taak buiten werking stellen wanneer een nieuwe run wordt gestart. Zie Een taak uitvoeren met verschillende parameters.
Taakparametersleutels kunnen alleen alfanumerieke tekens bevatten _ - . . Parameter values zijn set als tekenreeksen of als 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']
Taak toevoegen of bewerken parameters
Gebruik het dialoogvenster Taak parameters om nieuwe parameterstoe te voegen, bestaande parametersleutels en valueste bewerken of parameterste verwijderen.
Als u parameters wilt bewerken met de gebruikersinterface van de werkruimte, select u een bestaande taak met behulp van de volgende stappen:
- Klik op
Werkstromen in de zijbalk. - Klik in de naamcolumnop de taaknaam.
- Klik in de zijbalk taakdetails op Bewerken parameters. Het dialoogvenster Taak parameters wordt weergegeven.
- Voeg parameters toe of bewerk dit met behulp van de velden sleutel en waarde.
- Klik op de
om een parameter te remove. - Klik op Opslaan om uw wijzigingen toe te passen.
Notitie
Klik op { } om de beschikbare dynamische waardeverwijzingen te list. Select een optie uit de list om deze naar het veld Waarde te insert.
Pushdown van taakparameter
Taak parameters wordt automatisch als sleutel-waarde paar parameters doorgegeven aan alle taken die de sleutelwaarde parametersaccepteren, waaronder de volgende taaktypen:
- Notebook
- Python-wiel (alleen als deze is geconfigureerd met trefwoordargumenten)
- SQL-query, verouderd dashboard of bestand
- Taak uitvoeren
Taak parameters, doorgegeven aan taken, is zichtbaar in de configuratie van de taak in de gebruikersinterface, samen met de geconfigureerde taak parameters.
Belangrijk
Taak parameters voorrang hebben op taak parameters. Als een taakparameter en een taakparameter dezelfde sleutel hebben, overschrijft de taakparameter de taakparameter.
Dynamische waardeverwijzingen naar taak parameters
Alle taken die dynamische waardeverwijzingen accepteren, hebben toegang tot taak parameters.
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 taak parameters overschrijven of nieuwe taken toevoegen wanneer u een taak uitvoert met verschillende parameters. Zie een taak uitvoeren met verschillende parameters.
U kunt taak parameters ook overschrijven wanneer u een taakuitvoering herstelt. Zie Mislukte en overgeslagen taken opnieuw uitvoeren.