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í. Viz Spuštění úlohy 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 podrobností úlohy klikně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 tlačítko odeberte parametr.
6. Kliknutím na Uložit použijte změny.

Poznámka:

Kliknutím na { } zobrazíte seznam dostupných odkazů na dynamickou hodnotu. Ze seznamu vyberte možnost, kterou chcete vložit do pole Hodnota .

Odsdílení parametrů úlohy

Parametry úlohy se automaticky odsadí jako parametry klíč-hodnota do všech úkolů, které přijímají parametry klíč-hodnota, které zahrnují následující typy ú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 úlohy předané úkolům jsou viditelné v konfiguraci úlohy v uživatelském rozhraní spolu s nakonfigurované parametry úkolu.

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 na parametry ú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é. Viz Spuštění úlohy s různými parametry.

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