Udostępnij przez

Integracja biblioteki zmiennych z potokami

Biblioteka zmiennych to nowy typ elementu w usłudze Microsoft Fabric, który umożliwia użytkownikom definiowanie zmiennych na poziomie obszaru roboczego i zarządzanie nimi, dzięki czemu mogą być wkrótce używane w różnych elementach obszaru roboczego, takich jak potoki, notesy, skrót dla usługi Lakehouse i nie tylko. Zapewnia ujednolicony i scentralizowany sposób zarządzania konfiguracjami, zmniejszając potrzebę wartości wpisanych na stałe i upraszczając procesy CI/CD, co ułatwia zarządzanie konfiguracjami w różnych środowiskach.

Jak używać biblioteki zmiennych z potokami

  1. Przejdź do obszaru roboczego i utwórz nowy element.

    Zrzut ekranu przedstawiający, gdzie dodać nowy element w wyróżnionym obszarze roboczym Fabric.

  2. Użyj filtru, aby znaleźć bibliotekę zmiennych lub przewiń w dół do sekcji Opracowywanie danych.

    Zrzut ekranu przedstawiający filtr dla nowego elementu biblioteki zmiennych.

  3. Wybierz pozycję Biblioteka zmiennych, aby utworzyć nową bibliotekę zmiennych. Wybierz nazwę i naciśnij pozycję Utwórz.

    Zrzut ekranu przedstawiający nowy element z biblioteki zmiennych z ustawioną nazwą i wyróżnionym przyciskiem Utwórz.

  4. Po utworzeniu biblioteki zmiennych zostanie wyświetlona strona główna. Kliknij pozycję + Nowy , aby dodać nową zmienną.

    Zrzut ekranu przedstawiający stronę początkową dla nowego elementu biblioteki zmiennych.

  5. Po dodaniu nowej zmiennej możesz skonfigurować zmienną i ustawić zestaw wartości Name, Type i Default. Możesz również dodać notatki.

    Zrzut ekranu przedstawiający konfiguracje, które mają być ustawione dla nowej zmiennej.

  6. Dodaj zestawy wartości alternatywnych zgodnie z potrzebami (na przykład różne wartości dla różnych środowisk potoku wdrażania). Po ustawieniu nazwy i kliknięciu przycisku Utwórz możesz edytować wartości zmiennych i wybrać wartość ustawioną, aby uaktywnić.

    Zrzut ekranu przedstawiający miejsce dodawania nowych zestawów wartości dla zmiennej.

    Zrzut ekranu przedstawiający sposób dodawania nazwy nowego zestawu wartości.

  7. Zapisz zmiany po zakończeniu.

Zrzut ekranu przedstawiający przycisk Zapisz wyróżniony w lewym górnym rogu.

Używanie zmiennych z biblioteki w potoku

  1. Aby użyć zmiennej z biblioteki w potoku, utwórz nowy potok lub przejdź do istniejącego potoku.

    Zrzut ekranu przedstawiający przycisk Utwórz nowy element w lewym górnym rogu i wyróżniony element potoku.

  2. W potoku przetwarzania należy utworzyć odwołanie do biblioteki zmiennych w dolnym panelu.

    Zrzut ekranu przedstawiający kartę Zmienne biblioteki i przycisk +Nowy w dolnym panelu kanwy potoku.

  3. Po kliknięciu + Nowe zostanie otwarte okno podręczne z wyświetlonymi wszystkimi bibliotekami zmiennych. Możesz użyć tego selektora, aby wybrać zmienną biblioteki zmiennych i kliknąć przycisk OK.

    Zrzut ekranu przedstawiający wyróżniony przycisk +Nowy na karcie Zmienne biblioteki.

    Zrzut ekranu przedstawiający zmienną Biblioteki wybraną w selektorze zmiennych.

    Zrzut ekranu przedstawiający konfigurację dla nowego odwołania do zmiennej biblioteki.

  4. Po dodaniu odniesień do zmiennych bibliotecznych dodaj działania w potoku. W ustawieniach działania kliknij pozycję Dodaj zawartość dynamiczną dla ustawienia, które chcesz sparametryzować.

    Zrzut ekranu przedstawiający wyróżnioną pozycję Dodaj zawartość dynamiczną w ustawieniach działania Lookup.

  5. Zostanie otwarty konstruktor wyrażeń. Jeśli nie widzisz zmiennych biblioteki, kliknij 3 kropki obok Funkcje i wybierz Zmienne biblioteki.

    Zrzut ekranu przedstawiający 3 kropki obok funkcji w kreatorze wyrażeń i podświetloną kartę zmiennych biblioteki.

  6. Kliknij odwołanie do zmiennej w Bibliotece, aby dodać nowe wyrażenie do konstruktora wyrażeń. Następnie kliknij przycisk OK , aby dodać wyrażenie.

    Zrzut ekranu przedstawiający wyróżnione odwołanie do zmiennej biblioteki, które ma zostać dodane do konstruktora wyrażeń.

    Zrzut ekranu przedstawiający ustawienie wyrażeń w konstruktorze wyrażeń.

  7. Zobaczysz teraz, że zawartość dynamiczna zostanie dodana do ustawienia działania.

    Zrzut ekranu przedstawiający zestaw wyrażeń jako zawartość dynamiczną w ustawieniach działania Lookup.

  8. Możesz wyświetlić podgląd danych, klikając pozycję Podgląd danych. Spowoduje to otwarcie nowego okienka zawierającego wartość zmiennej biblioteki. Kliknij przycisk OK , aby uzyskać podgląd danych.

    Zrzut ekranu przedstawiający opcję danych podglądu.

    Zrzut ekranu przedstawiający okienko danych w wersji zapoznawczej.

  9. Zapisz i uruchom pipeline tak, jak zwykle. Zobaczysz, że przekazana wartość to dowolna wartość ustawiona jako Aktywna w bibliotece zmiennych.

    Zrzut ekranu przedstawiający ustawienia Zapisz i Uruchom wyróżnione na kanwie potoku.

Znane ograniczenia

Następujące znane ograniczenia dotyczą integracji biblioteki Zmiennych w potokach usługi Data Factory w ramach Microsoft Fabric:

  • Biblioteka zmiennych obsługuje typy danych typu Boolean, Datetime, Guid, Integer, Number i String. W swoim potoku zobaczysz wartość logiczną jako typ Bool, Datetime jako typ ciągu, identyfikator Guid jako typ ciągu, liczba całkowita jako typ Int i ciąg jako typ ciągu. Typy liczb nie są obsługiwane w rurociągach.
  • Parametryzacja połączenia zewnętrznego jest obsługiwana z biblioteką zmiennych parametrów zintegrowaną z potokami danych. Należy jednak wyszukać identyfikator GUID dla połączenia w obszarze Ustawienia | Zarządzanie połączeniami i bramami. W tym miejscu znajdziesz identyfikator GUID połączenia, wybierając pozycję Ustawienia obok nazwy połączenia.

Powiązana zawartość

  • Last updated on