Konwertowanie parametrów globalnych Azure Data Factory na biblioteki zmiennych usługi Fabric Data Factory

Fabric używa bibliotek zmiennych w obszarach roboczych do definiowania stałych używanych w potokach oraz innych elementach usługi Data Factory i platformy Fabric. Możesz migrować globalne parametry Azure Data Factory do bibliotek zmiennych Fabric za pomocą kilku ręcznych kroków.

Ten przewodnik przeprowadzi Cię przez proces:

  • Eksportuj globalne parametry Azure Data Factory
  • Tworzenie zmiennych obszaru roboczego w Fabric
  • Aktualizacja wyrażeń potoku
  • Sprawdzanie poprawności zachowania

Omówienie biblioteki zmiennych Fabric

Biblioteka zmiennych w Fabric przechowuje wartości na poziomie przestrzeni roboczej, do których możesz się odwoływać w różnych potokach i działaniach. Obsługuje typy, takie jak łańcuch znaków, liczba i wartość logiczna, a także bezpieczne wartości dla sekretów. Biblioteki zmiennych można wersjonować i wdrażać w różnych środowiskach przy użyciu potoków wdrażania.

W przeciwieństwie do globalnych parametrów Azure Data Factory, zmienne Fabric oferują bardziej rygorystyczne zabezpieczenia, łatwiejsze ponowne wykorzystanie i lepsze zarządzanie systemem. Można je zastosować we wszystkich elementach Fabric. Aby uzyskać więcej informacji, zobacz Wprowadzenie do bibliotek zmiennych.

Migrowanie parametrów globalnych usługi Azure Data Factory do biblioteki zmiennych w usłudze Fabric

  1. Wyeksportuj globalne parametry Azure Data Factory.

    1. W Azure Data Factory Studio przejdź do Manage>Global Parameters. Rejestruj nazwę, typ i wartość każdego parametru.
    2. W przypadku dużych migracji przejdź do artykułu Zarządzanie>szablonem usługi ARM i eksportowanie szablonów usługi ARM w celu programowego wyodrębniania parametrów. Można je znaleźć w folderze szablonu, w folderze fabryki, w pliku, który kończy się na ParametersForFactory

  2. Porównaj dostępne typy.

    Przejrzyj swoje globalne typy parametrów w Azure Data Factory (string, int, bool itd.) i porównaj je z typami bibliotek zmiennych w Fabric. Zanotuj wszelkie różnice typów, które mogą wymagać korekt podczas migracji.

  3. Tworzenie biblioteki zmiennych w Fabric.

    1. W obszarze roboczym Fabric wybierz pozycję + Nowy element a następnie wyszukaj i wybierz Variable library.
    2. Utwórz bibliotekę (na przykład GlobalParams).
    3. Otwórz bibliotekę nowej zmiennej, wybierz +Nową zmienną i każdy globalny parametr Azure Data Factory jako zmienną.

    Aby uzyskać więcej informacji na temat tworzenia bibliotek zmiennych, zobacz Wprowadzenie do bibliotek zmiennych.

  4. Zaktualizuj zmigrowane wyrażenia przepływu.

    Zaktualizuj odwołania do parametrów globalnych, takich jak @globalParameters('ParamName'), na odwołania do biblioteki zmiennych, takich jak @pipeline.libraryVariables.ParamName.

    Zaktualizuj wszystkie wyrażenia działań, parametry połączenia, argumenty skryptu, logikę filtru i właściwości zestawu danych. Aby uzyskać więcej informacji, zobacz Integracja biblioteki zmiennych z potokami danych.

  5. Zweryfikuj zachowanie pipeline.

    Uruchom walidację i wykonania testów, aby potwierdzić prawidłowe rozpoznawanie zmiennych w potokach. Sprawdź, czy połączenia, powiązania parametrów i bezpieczne użycie zmiennych działają zgodnie z oczekiwaniami.

Typowe wzorce migracji

Poniżej przedstawiono niektóre wzorce migracji, których można użyć podczas konwertowania parametrów globalnych na biblioteki zmiennych:

  • Bezpośrednie mapowanie — Proste parametry Azure Data Factory, takie jak mapowanie nazw regionów lub tenantów jeden do jednego na zmienne wpisy biblioteki.

  • Biblioteki specyficzne dla środowiska — zamiast jednej biblioteki utwórz wiele bibliotek (Global-Dev, Global-Test, Global-Prod). Procesy wdrażania mogą powiązać poprawną bibliotekę w zależności od środowiska.

  • Model hybrydowy — zachowaj stałe udostępnione w bibliotece zmiennych, ale przekaż informacje specyficzne dla przebiegu za pomocą parametrów potoku.

Bieżące ograniczenia

Obecnie należy pamiętać o kilku ograniczeniach:

  • Ani wbudowane doświadczenie uaktualnienia, ani narzędzie do migracji programu PowerShell nie migrują automatycznie parametrów globalnych.
  • Wyrażenia wewnątrz połączonych usług lub potoków, które odwołują się do @globalParameters(), nie są automatycznie zastępowane.
  • Fabric connections (zamiennik dla połączonych usług Azure Data Factory) nie obsługują wyrażeń parametrów w taki sam sposób. Należy ręcznie utworzyć ponownie wszystkie parametry dynamiczne używane w definicjach połączeń.

Najlepsze rozwiązania

Pamiętaj o następujących wskazówkach:

  • Dostosowanie konwencji nazewnictwa przed migracją.
  • Unikaj przeciążania zmiennych na poziomie obszaru roboczego. Zamiast tego użyj parametrów potoku dla wartości czasu wykonywania.
  • Użyj potoków wdrażania, aby zarządzać bibliotekami zmiennych specyficznych dla środowiska.
  • Udokumentuj bibliotekę zmiennych, aby członkowie zespołu wiedzieli, które pipelines zależą od zmiennych.

Treści powiązane

  • Last updated on