Konfigurera jobb parameters

I den här artikeln beskrivs funktioner för jobbparametrar och hur du konfigurerar jobb parameters med användargränssnittet för Databricks-arbetsytan. Du kan också lägga till jobb parameters till 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 jobb parameters?

Jobb parameters är nyckel/värde-par som gör att du kan parametrisera jobb med statisk eller dynamisk standard values. Du kan valfritt åsidosätta parameters som konfigurerats i ett jobb när du utlöser en ny körning. Se Kör ett jobb med olika parameters.

Jobbparameternycklar kan bara innehålla _ - . eller alfanumeriska tecken. Parametrarna values anges som set i form av 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 jobb parameters

Använd dialogrutan Jobb parameters för att lägga till nya parameters, redigera befintliga parameternycklar och valueseller ta bort parameters.

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

1. Klicka på Arbetsflöden i sidofältet.
2. I Namncolumnklickar du på jobbnamnet.
3. I jobbinformationen sidofältet klickar du på Redigera parameters. Dialogrutan Jobb parameters visas.
4. Lägg till eller redigera parameters med hjälp av fälten Key och Value.
5. Klicka på för att remove en parameter.
6. Klicka på Spara för att tillämpa dina ändringar.

Kommentar

Klicka på { } för att list tillgängliga dynamiska värdereferenser. Select ett alternativ från list för att insert det till fältet Value.

Pushdown för jobbparameter

Jobb parameters skickas automatiskt ned som ett nyckelvärde parameters till alla uppgifter som accepterar nyckelvärde parameters, och omfattar följande typer av uppgifter:

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

Jobb parameters som skickas till uppgifter visas i uppgiftskonfigurationen i användargränssnittet tillsammans med den konfigurerade uppgiften parameters.

Viktigt!

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

Referenser till dynamiska värden för jobb parameters

Alla aktiviteter som accepterar referenser till dynamiska värden kan komma åt uppgift parameters.

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

Kör ett jobb med olika parameters

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

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