Delen via

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 Databricks Asset Bundles. 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.

Taakparameter-sleutels kunnen alleen _ - . of 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:

  1. Klik in de zijbalk van uw Azure Databricks-werkruimte op Jobs & Pipelines.
  2. Selecteer desgewenst de filters Werk en Van mij.
  3. Klik op de koppeling Naam van uw taak.
  4. Klik in de zijbalk taakdetails op Parameters bewerken. Het dialoogvenster Taakparameters wordt weergegeven.
  5. Parameters toevoegen of bewerken met Sleutel en waarde velden.
  6. Klik op de Prullenbak om een parameter te verwijderen.
  7. 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 te voegen in het veld waarde.

Doordrukking van taakparameter

Taakparameters worden automatisch naar beneden gepusht als sleutelwaardeparameters voor alle taken die sleutelwaardeparameters accepteren, waaronder de volgende taaktypen:

  • Notitieboek
  • 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 dynamische waarde {{job.parameters.<name>}}, vervang <name> door de key 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 instellingen.

U kunt ook taakparameters overschrijven wanneer u een taakrun herstelt. Zie Mislukte en overgeslagen taken opnieuw uitvoeren.