Udostępnij za pośrednictwem

Używanie bibliotek zmiennych Fabric w przepływie danych Gen2

Uwaga / Notatka

Aby uzyskać więcej informacji na temat sposobu wykorzystania tej funkcji w scenariuszach ciągłej integracji/ciągłego wdrażania (CI/CD), zapoznaj się z artykułem na temat architektur rozwiązań CI/CD i ALM dla Dataflow Gen2 oraz pełnym samouczkiem dotyczącym odwołań do zmiennych w przepływie danych.

Biblioteki zmiennych Fabric oferują scentralizowany sposób zarządzania wartościami konfiguracji w Microsoft Fabric workloads. Dzięki nowej integracji w usłudze Dataflow Gen2 można odwoływać się do tych zmiennych bezpośrednio w przepływie danych, zapewniając dynamiczne działanie w różnych środowiskach i upraszczając przepływy pracy CI/CD.

Wymagania wstępne

Aby użyć bibliotek zmiennych Fabric w usłudze Dataflow Gen2, upewnij się, że:

Odwoływanie się do zmiennych za pomocą widżetów wejściowych

Okna dialogowe przepływu danych Gen2 zawierają widżet wejściowy, który umożliwia wybranie sposobu wprowadzania wartości pola. W obsługiwanych oknach dialogowych można wybrać zmienne przy użyciu tego widżetu.

Zrzut ekranu przedstawiający widżet wprowadzania w oknie dialogowym filtrowania wierszy, pokazujący wiele opcji dostępnych dla danych wejściowych.

Uwaga / Notatka

Aby użyć widżetu wejściowego, na karcie Widok na wstążce w grupie Parametry wybierz pozycję Zawsze zezwalaj. Zrzut ekranu przedstawiający pole wyboru „Zawsze zezwalaj” na karcie „Widok” wstążki, umożliwiające włączenie widżetu wejściowego.

Niektóre okna dialogowe obsługują środowisko komponentów wejściowych i biblioteki zmiennych Fabric, w tym:

Po wybraniu opcji zmiennej w widżecie wejściowym zostanie wyświetlone okno dialogowe selektora zmiennych. W tym oknie dialogowym możesz przeglądać biblioteki zmiennych i zawarte w nich zmienne.

Zrzut ekranu przedstawiający okno dialogowe wybierania zmiennej z wyświetlonymi wszystkimi dostępnymi bibliotekami i zmiennymi w bieżącym obszarze roboczym.

Po wybraniu zmiennej w oknie dialogowym zostanie wyświetlona nazwa biblioteki i zmiennej, aby można było potwierdzić wybór przed zatwierdzeniem.

Zrzut ekranu zmiennej o nazwie Ceiling z biblioteki My library pokazana jako wybrana w oknie dialogowym filtrowania wierszy.

Uwaga / Notatka

Nie wszystkie środowiska przepływu danych obsługują widżet wejściowy. W przypadku nieobsługiwanych środowisk lub scenariuszy niestandardowych użyj funkcji zmiennych ręcznie.

Funkcje zmiennych

Wewnątrz przepływu danych Gen2 można odwoływać się do zmiennej przy użyciu jednej z następujących funkcji:

Identyfikator przekazywany do jednej z funkcji musi mieć następujący format:

$(/**/LibraryName/VariableName)

W poniższych przykładach założono, że biblioteka zmiennych o nazwie Moja biblioteka i zmienna ciągu o nazwie Moja zmienna:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

Użycie wartości domyślnej poprzez Variable.ValueOrDefault pomaga zagwarantować, że formuła zostanie rozpoznana nawet podczas kopiowania lub przenoszenia rozwiązania do innego środowiska, które nie ma biblioteki zmiennych, do których się odwołano.

Wskazówka

Zapisz każdą zmienną jako osobne zapytanie, które nie wymaga buforowania. Takie podejście umożliwia użycie tych wartości w oknach dialogowych, które obsługują dane wejściowe zapytania i pomagają zachować zorganizowany widok zmiennych w przepływie danych.

Uwagi i ograniczenia

Poniższa lista zawiera ważne ograniczenia i zachowania, które należy wziąć pod uwagę podczas korzystania z bibliotek zmiennych Fabric z przepływem danych Gen2. Te ograniczenia mają wpływ na sposób odwoływania się, oceniania i stosowania zmiennych podczas projektowania i środowiska uruchomieniowego.

  • Zakres obszaru roboczego: biblioteki zmiennych muszą znajdować się w tym samym obszarze roboczym co przepływ danych Gen2 z CI/CD.

  • Lokalizacja odwołania: zmienne mogą być używane tylko wewnątrz pliku mashup.pq w przepływie danych Gen2 z ciągłą integracją/ciągłym wdrażaniem.

  • Zachowanie podczas operacji: wartości zmiennych są pobierane na początku operacji i zachowywane przez cały czas jej trwania. Zmiany w bibliotece podczas uruchamiania przepływu danych nie są zatrzymywane ani wpływają na ten przebieg.

  • Przy użyciu wartości domyślnej: w przypadku używania wartości domyślnej za pośrednictwem funkcji Variable.ValueOrDefault upewnij się, że typ danych wartości domyślnej jest zgodny z typem danych zmiennej, do którego odwołuje się odwołanie.

  • Obsługiwane typy: obsługiwane są tylko zmienne typów podstawowych (boolean, datetime, , guidinteger, numberi string).

  • Stałe połączenia: Zmienne nie mogą zmieniać informacji o połączeniu. Połączenia pozostają przypisane do utworzonych konfiguracji ścieżki zasobów.

  • Zastąpienie ryzyka: użytkownicy z dostępem do modyfikowania bibliotek zmiennych mogą zastąpić wartości zmiennych, potencjalnie wpływając na dane wyjściowe przepływu danych.

  • Mapowanie schematu: Zmienne nie mogą modyfikować mapowań schematów docelowych; mapowania są zgodne z konfiguracją utworzoną.

  • Widoczność pochodzenia: widoki pochodzenia nie pokazują łączy między Dataflow Gen2 a bibliotekami zmiennych, do których Dataflow Gen2 się odwołuje.

  • Last updated on