Globální parametry v Azure Data Factory

VZTAHUJE SE NA: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory v Microsoft Fabric je nová generace Azure Data Factory s jednodušší architekturou, integrovanou AI a novými funkcemi. Pokud s integrací dat začínáte, začněte Fabric Data Factory. Stávající úlohy ADF lze upgradovat na Fabric pro přístup k novým funkcím v oblastech datové vědy, analýz v reálném čase a vytváření sestav.

Globální parametry jsou konstanty v datové továrně, které kanály můžou využívat v libovolném výrazu. Jsou užitečné, když máte více kanálů s identickými názvy a hodnotami parametrů. Při propagaci datové továrny pomocí procesu kontinuální integrace a nasazování (CI/CD) můžete tyto parametry v každém prostředí přepsat.

Vytváření globálních parametrů

Pokud chcete vytvořit globální parametr, přejděte na kartu Globální parametry v části Spravovat . Výběrem možnosti Nový otevřete boční navigační panel pro vytvoření.

Snímek obrazovky se zvýrazněním tlačítka Nový, které vyberete pro vytvoření globálních parametrů

Na bočním navigačním panelu zadejte název, vyberte datový typ a zadejte hodnotu parametru.

Snímek obrazovky znázorňující, kam přidáte název, datový typ a hodnotu nového globálního parametru

Po vytvoření globálního parametru ho můžete upravit kliknutím na název parametru. Pokud chcete změnit více parametrů najednou, vyberte Upravit vše.

Vytvoření globálních parametrů

Použití globálních parametrů v potrubí

Globální parametry lze použít v libovolném výrazu pipeline. Pokud kanál odkazuje na jiný prostředek, jako je datová sada nebo tok dat, můžete předat globální hodnotu parametru prostřednictvím parametrů daného prostředku. Globální parametry jsou uváděny jako pipeline().globalParameters.<parameterName>.

Použití globálních parametrů

Globální parametry v CI/CD

Během CI/CD doporučujeme do šablony ARM zahrnout globální parametry. Nový mechanismus zahrnutí globálních parametrů do šablony ARM (z "Spravovat centrum" –> Šablona ARM –> Zahrnout globální parametry do šablony ARM), jak je znázorněno na následujícím obrázku, nebude konfliktní nebo přepíše nastavení na úrovni továrny, jak se používá dříve, a proto nevyžaduje další PowerShell pro globální nasazení parametrů během CI/CD.

Snímek obrazovky „Zahrnout do šablony ARM“

Poznámka:

Prostředí uživatelského rozhraní pro zahrnutí globálních parametrů z oddílu Globální parametry jsme přesunuli do oddílu Šablona ARM v centru Správa.

Pokud už používáte starší mechanismus (z nabídky Spravovat centrum –> Globální parametry –> Zahrnout do šablony ARM), můžete pokračovat. Budeme ho dál podporovat.

Složka Parametry ve stažené šabloně ARM obsahuje soubory JSON, které definují parametry použité v šabloně ARM. Každý soubor odpovídá určitému globálnímu parametru.

Pokud používáte starší tok integrace globálních parametrů do řešení kontinuální integrace a nasazování, bude dál fungovat:

  • Zahrnutí globálních parametrů do šablony ARM (ze správy centra –> Globální parametry –> Zahrnutí do šablony ARM) Snímek obrazovky se zastaralou možností Zahrnout do šablony ARM

  • Nasazení globálních parametrů pomocí skriptu PowerShellu

Důrazně doporučujeme využít nový mechanismus pro zahrnutí globálních parametrů do šablony ARM (ze Správy centra –> Šablona ARM –> Zahrnutí globálních parametrů do šablony ARM), protože použití globálních parametrů v CICD výrazně zjednodušuje a usnadňuje jejich správu.

Poznámka:

Konfigurace zahrnout globální parametry do šablony ARM je k dispozici pouze v "Git mode". V současné době je zakázaný v živém režimu nebo v režimu Data Factory.

Varování

V názvu parametru nelze použít -. Zobrazí se kód chyby {"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=Výraz >'pipeline().globalParameters.myparam-dbtest-url' není platný: .....}". V názvu parametru ale můžete použít "_".