Konfigurera jobbparametrar

  • Artikel

I den här artikeln beskrivs funktioner för jobbparametrar och hur du konfigurerar jobbparametrar med användargränssnittet för Databricks-arbetsytan. Du kan också lägga till jobbparametrar i JSON- och YAML-definitioner som används med REST API, CLI och DAB. Se Jobb-API, Vad är Databricks CLI?, och Vad är Databricks-tillgångspaket?.

Vad är jobbparametrar?

Jobbpar är nyckel/värde-par som gör att du kan parametrisera jobb med statiska eller dynamiska standardvärden. Du kan också åsidosätta parametrar som konfigurerats i ett jobb när du utlöser en ny körning. Se Köra ett jobb med olika parametrar.

Jobbparameternycklar kan bara innehålla _ - . eller alfanumeriska tecken. Parametervärden anges som strängar eller dynamiska värdereferenser. Se Vad är en referens för dynamiskt värde?.

Kommentar

Du kan använda valfritt giltigt JSON som parametervärde. Aktivitetstypen For each kan till exempel parsa listor, till exempel följande:

[1, 2, 3]
['a', 'b', 'c']

Lägga till eller redigera jobbparametrar

Använd dialogrutan Jobbparametrar för att lägga till nya parametrar, redigera befintliga parameternycklar och värden eller ta bort parametrar.

Om du vill redigera parametrar med arbetsytans användargränssnitt väljer du ett befintligt jobb med hjälp av följande steg:

  1. Klicka på Ikon för arbetsflöden Arbetsflöden i sidofältet.
  2. Klicka på jobbnamnet i kolumnen Namn.
  3. I sidofältet Jobbinformation klickar du på Redigera parametrar. Dialogrutan Jobbparametrar visas.
  4. Lägg till eller redigera parametrar med hjälp av nyckel- och värdefält .
  5. Klicka på för Papperskorgen att ta bort en parameter.
  6. Klicka på Spara för att tillämpa dina ändringar.

Kommentar

Klicka på { } för att visa tillgängliga referenser för dynamiskt värde. Välj ett alternativ i listan för att infoga det i fältet Värde .

Pushdown för jobbparameter

Jobbparametrar pushas automatiskt ned som nyckel/värde-parametrar till alla aktiviteter som accepterar nyckel/värde-parametrar, som innehåller följande aktivitetstyper:

  • Notebook-fil
  • Python-hjul (endast när det konfigureras med nyckelordsargument)
  • SQL-fråga, äldre instrumentpanel eller fil
  • Kör jobb

Jobbparametrar som skickas till aktiviteter visas i aktivitetskonfigurationen i användargränssnittet tillsammans med konfigurerade aktivitetsparametrar.

Viktigt!

Jobbparametrar har företräde framför aktivitetsparametrar. Om en jobbparameter och en aktivitetsparameter har samma nyckel åsidosätter jobbparametern aktivitetsparametern.

Referenser till dynamiskt värde till jobbparametrar

Alla aktiviteter som accepterar referenser för dynamiskt värde har åtkomst till jobbparametrar.

Använd referensen {{job.parameters.<name>}}för dynamiskt värde och ersätt <name> med parametern key som identifierar parametern.

Köra ett jobb med olika parametrar

Du kan åsidosätta konfigurerade jobbparametrar eller lägga till nya när du kör ett jobb med olika parametrar. Se Köra ett jobb med olika parametrar.

Du kan också åsidosätta jobbparametrar när du reparerar en jobbkörning. Se Kör om misslyckade och överhoppade uppgifter.