Konfigurace parametrů úlohy

Tento článek popisuje funkce parametrů úlohy a konfiguraci parametrů úlohy pomocí uživatelského rozhraní pracovního prostoru Databricks. Do definic JSON a YAML, které se používají s rozhraním REST API, rozhraním příkazového řádku a databázemi DAB, můžete také přidat parametry úlohy. Viz rozhraní API pro úlohy, co je Rozhraní příkazového řádku Databricks? a Co jsou sady prostředků Databricks?

Co jsou parametry úlohy?

Parametry úlohy jsou páry klíč-hodnota, které umožňují parametrizovat úlohy s výchozími statickými nebo dynamickými hodnotami. Volitelně můžete přepsat parametry nakonfigurované v úloze při aktivaci nového spuštění. Podívejte se na Spustit úlohu s různými parametry.

Klíče parametrů úlohy můžou obsahovat _ - . pouze alfanumerické znaky. Hodnoty parametrů jsou nastaveny jako řetězce nebo dynamické odkazy na hodnoty. Podívejte se, co je odkaz na dynamickou hodnotu?

Poznámka:

Jako hodnotu parametru můžete použít libovolný platný JSON. Například typ úkolu může analyzovat seznamy, For each například následující:

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

Přidání nebo úprava parametrů úlohy

Pomocí dialogového okna Parametry úlohy můžete přidat nové parametry, upravit existující klíče parametrů a hodnoty nebo odstranit parametry.

Pokud chcete upravit parametry pomocí uživatelského rozhraní pracovního prostoru, vyberte existující úlohu pomocí následujícího postupu:

1. Na bočním panelu klikněte na Pracovní postupy.
2. Ve sloupci Název klikněte na název úlohy.
3. Na bočním panelu Podrobnosti úlohy klepněte na Upravit parametry. Zobrazí se dialogové okno Parametry úlohy.
4. Přidejte nebo upravte parametry pomocí polí Klíč a Hodnota.
5. Kliknutím na odeberte parametr.
6. Kliknutím na Uložit použijte změny.

Poznámka:

Kliknutím na tlačítko { } zobrazíte seznam dostupných odkazů na dynamické hodnoty. Ze seznamu vyberte možnost, kterou chcete vložit do pole Hodnota.

Odsdílení parametrů úlohy

Parametry úlohy se automaticky předají jako parametry klíč-hodnota všem úkolům, které je akceptují, včetně následujících typů úkolů:

• Poznámkový blok
• Kolo Pythonu (pouze při konfiguraci s argumenty klíčových slov)
• Dotaz SQL, starší verze řídicího panelu nebo soubor
• Spustit úlohu

Parametry úloh předávané úkolům jsou viditelné v konfiguraci úkolů v uživatelském rozhraní spolu s nakonfigurovanými parametry úkolů.

Důležité

Parametry úlohy mají přednost před parametry úkolu. Pokud má parametr úlohy a parametr úkolu stejný klíč, přepíše parametr úlohy parametr úkolu.

Dynamické odkazy na hodnoty parametrů úlohy

Všechny úkoly, které přijímají odkazy na dynamické hodnoty, mají přístup k parametrům úlohy.

Použijte odkaz {{job.parameters.<name>}}na dynamickou hodnotu a nahraďte <name> ho parametrem key .

Spuštění úlohy s různými parametry

Při spuštění úlohy s různými parametry můžete přepsat nakonfigurované parametry úlohy nebo přidat nové. Podívejte se na Spustit úlohu s různými parametry.

Parametry úlohy můžete také přepsat při opravě běhu úlohy. Viz Znovu spustit neúspěšné a přeskočené úlohy.