Parametrizace úloh

Tento článek poskytuje přehled o použití parametrů s úlohami a pracovními ú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ů úlohy.
• odkazy na dynamické hodnoty: Syntaxe pro odkazy na podmínky úlohy, metadata a parametry. Podívejte se, co je odkaz na dynamickou hodnotu?
• hodnoty úloh: Syntaxe pro zaznamenání a odkazování na hodnoty generované během spuštění úlohy. 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 práce a úkolu?

Parametry úlohy jsou páry klíč-hodnota definované na úrovni úlohy. Výchozí nastavení parametrů úlohy můžete přepsat, když teď Spustit s různými parametry nebo aktivovat spuštění úlohy pomocí rozhraní REST API. Parametry úlohy se přenášejí 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í dílčí modul dbutils.widgets, zatímco skripty Pythonu předávají hodnoty jako argumenty skriptu, jako by se volala 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 přepsat, když Spustit nyní s různými parametry 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 procházejte jej v pro každou úlohu.
• Vytvoření logiky forku na základě počtu záznamů zpracovaných pomocí úlohy podmínky If/else
• Odkazujte na parametry z jiných úkolů.

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