Parametrizace úloh

Parametry umožňují předávat hodnoty do úlohy a jejích úkolů a odkazovat hodnoty mezi úkoly. Tento článek představuje typy parametrů, které jsou k dispozici v úlohách Lakeflow a jak je nakonfigurovat v uživatelském rozhraní. Musíte také aktualizovat prostředky zdrojového kódu, které konfigurujete jako úkoly, aby odkazovaly na parametry. Odkazy na parametry se liší podle jazyka a typu úlohy. Podívejte se na hodnoty parametrů Accessu z úkolu.

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

• Parametry úlohy: Dvojice klíč-hodnota definované na úrovni úlohy a předávané úkolům. 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 odkazování na podmínky úlohy, metadata a parametry při konfiguraci úloh. Viz odkazy na dynamické hodnoty.
• 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.
• Hodnoty přístupových parametrů v kódu: Jak číst hodnoty parametrů z kódu úkolu podle typu úkolu. Podívejte se na hodnoty parametrů Accessu z úkolu.

Co můžete dělat s parametry

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

• Přidejte rozšiřitelnou logiku do zdrojů kódu
• Podmínkování spuš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 stavové informace v běhu úlohy

Parametry úlohy vs. parametry úkolu

Parametry úlohy jsou páry klíč-hodnota definované na úrovni úlohy. Výchozí nastavení parametrů úlohy můžete přepsat, když spustíte nyní s různými parametry nebo aktivujete 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.

Poznámka:

Každý uživatel s oprávněním CAN MANAGE RUN nebo vyšším pro úlohu může při ručním spuštění přepsat hodnoty parametrů úlohy pomocí možnosti Spustit nyní s jinými parametry. Výchozí hodnota parametru není ovládací prvek zabezpečení. Pokud chcete zabránit změnám, omezte oprávnění úlohy.

Parametry úlohy jsou páry klíč-hodnota nebo pole JSON definovaná 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. Podívejte se na hodnoty parametrů Accessu z úkolu.

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řidejte logiku 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í:

• Použijte parametr úlohy jako output_table pro jeden úkol a input_table pro jiný úkol.
• Zachyťte výstup dotazu poznámkového bloku jako seznam a procházejte jej v pro každou úlohu.
• Vytvoření logiky větvení na základě počtu zpracovaných záznamů pomocí úlohy podmínky if/else.
• Odkazujte na parametry z jiných úkolů.

Viz odkazy na dynamické hodnoty.