Udostępnij za pośrednictwem

Parametry globalne w usłudze Azure Data Factory

  • Artykuł

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

Parametry globalne to stałe w fabryce danych, które mogą być używane przez potok w dowolnym wyrażeniu. Są one przydatne, gdy masz wiele potoków z identycznymi nazwami parametrów i wartościami. Podczas promowania fabryki danych przy użyciu procesu ciągłej integracji i wdrażania (CI/CD) można zastąpić te parametry w każdym środowisku.

Tworzenie parametrów globalnych

Aby utworzyć parametr globalny, przejdź do karty Parametry globalne w sekcji Zarządzanie . Wybierz pozycję Nowy , aby otworzyć nawigację po stronie tworzenia.

Zrzut ekranu z wyróżnionym przyciskiem Nowy, który wybierzesz, aby utworzyć parametry globalne.

W okienku nawigacji bocznej wprowadź nazwę, wybierz typ danych i określ wartość parametru.

Zrzut ekranu przedstawiający miejsce dodawania nazwy, typu danych i wartości dla nowego parametru globalnego.

Po utworzeniu parametru globalnego można go edytować, klikając nazwę parametru. Aby zmienić wiele parametrów jednocześnie, wybierz pozycję Edytuj wszystko.

Utwórz parametry globalne

Używanie parametrów globalnych w potoku

Parametry globalne mogą być używane w dowolnym wyrażeniu potoku. Jeśli potok odwołuje się do innego zasobu, takiego jak zestaw danych lub przepływ danych, możesz przekazać wartość parametru globalnego za pomocą parametrów tego zasobu. Parametry globalne są przywołyne jako pipeline().globalParameters.<parameterName>.

Używanie parametrów globalnych

Parametry globalne w ramach ciągłej integracji/ciągłego wdrażania

Zalecamy uwzględnienie parametrów globalnych w szablonie usługi ARM podczas ciągłej integracji/ciągłego wdrażania. Nowy mechanizm dołączania parametrów globalnych w szablonie usługi ARM (z "Zarządzanie koncentratorem" —> "Szablon usługi ARM" —> "Uwzględnianie parametrów globalnych w szablonie usługi ARM"), jak pokazano poniżej, nie spowoduje konfliktu/zastąpienia ustawień na poziomie fabryki, tak jak wcześniej, dlatego nie wymaga dodatkowego programu PowerShell do wdrożenia parametrów globalnych podczas ciągłej integracji/ciągłego wdrażania.

Zrzut ekranu przedstawiający opcję

Uwaga

Przenieśliśmy środowisko interfejsu użytkownika, aby włączyć parametry globalne z sekcji "Parametry globalne" do sekcji "Szablon usługi ARM" w centrum zarządzania. Jeśli używasz już starszego mechanizmu (z obszaru "Zarządzanie koncentratorem" — "Parametry globalne" —>> "Uwzględnij w szablonie usługi ARM"), możesz kontynuować. Będziemy nadal go wspierać.

Folder Parameters w pobranym szablonie usługi ARM zawiera pliki JSON, które definiują parametry używane w szablonie usługi ARM. Każdy plik odpowiada określonemu parametrowi globalnemu.

Jeśli używasz starszego przepływu integrowania parametrów globalnych w rozwiązaniu do ciągłej integracji i wdrażania, będzie nadal działać:

  • Uwzględnij parametry globalne w szablonie usługi ARM (z obszaru "Zarządzanie koncentratorem" —> "Parametry globalne" —> "Uwzględnij w szablonie usługi ARM") Zrzut ekranu przedstawiający przestarzałą pozycję

  • Wdrażanie parametrów globalnych za pomocą skryptu programu PowerShell

Zdecydowanie zalecamy użycie nowego mechanizmu dołączania parametrów globalnych w szablonie usługi ARM (z "Zarządzanie koncentratorem" —> "Szablon usługi ARM" —> "Uwzględnianie parametrów globalnych w szablonie usługi ARM"), ponieważ sprawia, że identyfikator CICD z parametrami globalnymi jest znacznie prostszy i łatwiejszy w zarządzaniu.

Uwaga

Dołączanie parametrów globalnych w konfiguracji szablonu usługi ARM jest dostępne tylko w trybie Git. Obecnie jest ona wyłączona w „trybie na żywo” lub w trybie „ fabryki danych”.

Ostrzeżenie

Nie można użyć ciągu "-" w nazwie parametru. Zostanie wyświetlony kod błędu "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=Wyrażenie >"pipeline().globalParameters.myparam-dbtest-url" jest nieprawidłowe: .....}". Można jednak użyć ciągu "_" w nazwie parametru.

Powiązana zawartość