Parametrizace úloh

Tento článek obsahuje přehled použití parametrů s úlohami a úkoly.

Níže jsou uvedené základní koncepty pro pochopení parametrů pro úlohy:

• Parametr úlohy: Dvojice klíč-hodnota definovaná na úrovni úlohy a odsadila se do úkolů. Viz Konfigurace parametrů úlohy.
• Parametr úkolu: Pár klíč-hodnota nebo pole JSON definované na úrovni úlohy. Viz Konfigurace parametrů úkolu.
• Odkazy na dynamické hodnoty: Syntaxe pro odkazy na podmínky úlohy, metadata a parametry. Podívejte se, co je odkaz na dynamickou hodnotu?
• Hodnoty úkolů: Syntaxe pro zachytávání a odkazování na hodnoty vygenerované během spuštění úloh. Viz Použití hodnot úkolů k předávání informací mezi úkoly.

Co můžete s parametry dělat?

Přidejte do úloh a úkolů parametry pro pokročilé případy použití, včetně následujících:

• Přidání rozšiřitelné logiky do prostředků kódu
• Podmíněné spouštění.
• Odkazovat na běžné parametry napříč několika úlohami
• Použijte informace vygenerované v jednom úkolu v jiném úkolu.
• Referenční metadata a informace o stavu při spuštění úlohy

Jaký je rozdíl mezi parametry úlohy a úkolu?

Parametry úlohy jsou páry klíč-hodnota definované na úrovni úlohy. Výchozí nastavení parametrů úlohy můžete po spuštění přepsat pomocí různých parametrů nebo spustit úlohu pomocí rozhraní REST API. Parametry úlohy se odsílají do úkolů, které používají parametry klíč-hodnota. Jiné úkoly můžou odkazovat na parametry úlohy pomocí odkazů na dynamické hodnoty.

Parametry úlohy jsou páry klíč-hodnota polí JSON definovaných na úrovni úlohy. Každý typ úkolu předá hodnoty úkolů nakonfigurovaným prostředkům kódu odlišně. Například úlohy poznámkového bloku používají dbutils.widgets dílčí modul, zatímco skripty Pythonu předávají do skriptu hodnoty jako argumenty, jako by byly volány z příkazového řádku. Podřízené úkoly mohou odkazovat na parametry úkolů z nadřazených úkolů pomocí odkazů na dynamické hodnoty.

Poznámka:

Některé úkoly nemají vyhrazené pole Parametry , ale umožňují odkazy na hodnoty úkolů nebo dynamické odkazy na hodnoty v jiných polích. Podívejte se na příklady parametrizovaných příkazů dbt a přidání logiky větvení do úlohy s úlohou If/else.

Vytváření pracovních postupů pomocí dynamických hodnot

Parametry úlohy nastavené se statickými hodnotami lze přepsat pouze aktualizací definice úlohy. Nastavení statické hodnoty parametru úlohy pouze konfiguruje výchozí hodnotu, kterou můžete po spuštění přepsat pomocí různých parametrů nebo aktivovat spuštění úlohy pomocí rozhraní REST API.

Při definování parametrů úlohy použijte odkazy na dynamické hodnoty k implementaci vzorů, jako jsou například následující:

• Jako parametr output_table úlohy použijte jeden úkol a input_table druhý.
• Zachyťte výstup dotazu poznámkového bloku jako seznam a pro každý úkol ho smyčkejte.
• Vytvoření logiky forku na základě počtu záznamů zpracovaných pomocí úlohy podmínky If/else
• Projděte si parametry z jiných úkolů.

Podívejte se, co je odkaz na dynamickou hodnotu?