Použijte parametry v Lakeflow Designeru

Parametry jsou pojmenované hodnoty definované pro přípravu vizuálních dat jako celek. Parametry můžete odkazovat v SQL a Python operátorovém kódu, v podporovaných konfiguračních polích operátorů a ve výrazech, které operátory povolují nebo zakázají. Parametry umožňují spouštět stejnou vizuální přípravu dat v různých prostředích, například testovací katalog během vývoje a produkční katalog v produkci.

Definujte parametry

Pro správu parametrů vyberte Parametry v levém panelu. Každý parametr má hodnotu, kterou nastavíte při definování. Když vizuální příprava dat běží podle plánu nebo jako úkol, můžete tuto hodnotu přepsat. Vizte Přepsání hodnot parametrů v produkci.

Panel uvádí operátory, které používají jednotlivé parametry. Vyberte jméno operátora, abyste ho zvýraznili na plátně.

Odkaz na parametr z operátoru

Jak parametr odkazujete, závisí na tom, kde ho použijete:

  • Operátor SQL: Použijte syntaxi pojmenovaných značek parametrů, například :environment. Viz Použití pojmenovaných značek parametrů.
  • Operátor jazyka Python: Zavolejte dbutils.widgets.get(), například dbutils.widgets.get("environment"). Viz nástroj Widgets (dbutils.widgets).
  • Podporovaná konfigurační pole operátora: V konfiguračním panelu operátora vyberte Parametry v pravém horním rohu. Vyberte pole a zadejte výraz jako :source_table. Podporované oblasti zahrnují:
    • Zdroj: tabulka, cesta k souboru a formát souboru.
    • Výstup: Katalog, Schéma, Tabulka, Pohled, Svazek, Název souboru a Režim zápisu.
    • Limit: Limit.
    • Kombinovat: Nastavit operaci, Sloučit strategii, sjednotit podle názvu a povolit chybějící sloupce.

Když otevřete operátor SQL nebo Python pro úpravy, Návrhář Lakeflow ukazuje příklad odkazu na dostupné parametry nad zdrojovým editorem.

Kombinujte parametry s pevně daným textem

V parametrickém výrazu pro zdrojový nebo výstupní operátor použijte :parameter_name k nahrazení celé hodnoty. Pro kombinaci parametrů s pevným textem uzavřete text do jednotlivých uvozovek a použijte ||. Například následující výraz Source Table vytváří plně kvalifikovaný název tabulky:

:catalog || '.' || :schema || '.' || :table

Povolení nebo zakázání operátoru pomocí parametru

Můžete použít parametr k povolení nebo vypnutí libovolného nakonfigurovaného operátora. V panelu Parametry vyberte Zakázáno a zadejte Booleovský výraz. Například :skip_operator deaktivuje operátor, když je parametr true. Operátor bez povolení nevytváří žádné výstupní řádky.

Pro manuální povolení nebo deaktivaci operátora viz Přejmenování, kopírování, mazání a deaktivace operátorů.

Přepsat hodnoty parametrů v produkci

Za běhu vizuální příprava dat čte parametry stejným způsobem, ať už běží interaktivně nebo jako úloha, takže stejný soubor funguje ve všech vašich prostředích bez změn. Uveďte různé hodnoty pro každé prostředí následovně:

  • Při plánování úlohy v uživatelském rozhraní: Přepište hodnoty parametrů pro každý plán. Například naplánujte, aby se stejná vizuální příprava dat spouštěla každý den v poledne s parametrem environment nastaveným na test, a znovu ve 14:00 s parametrem environment nastaveným na production. Viz Naplánovat jako úlohu.
  • Při nasazování pomocí sady: Nastavte hodnoty parametrů prostřednictvím úlohy parametersa použijte cíle sady k zadání různých hodnot pro každé prostředí. Sady vývojových a produkčních cílů umožňují nasadit stejnou úlohu do samostatných prostředí s nastavením specifickými pro prostředí. Viz režimy nasazení deklarativních balíčků automatizace a konfiguraci deklarativních balíčků automatizace.

Další prostředky

  • Poslední aktualizace v