Używanie parametrów publicznych w przepływie danych Gen2

Wskazówka

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 dotyczącym architektur rozwiązań CI/CD dla Dataflow Gen2 oraz obszernym samouczkiem dotyczącym sparametryzowanego Dataflow Gen2.

Parametry w przepływie danych Gen2 umożliwiają dynamiczne kontrolowanie i dostosowywanie przepływów danych, dzięki czemu są bardziej elastyczne i wielokrotnego użytku, włączając różne dane wejściowe i scenariusze bez modyfikowania samego przepływu danych. Ułatwia to organizowanie elementów przez zmniejszenie zapotrzebowania na wiele przepływów danych i scentralizowaną kontrolę w ramach jednego sparametryzowanego przepływu danych.

Parametry publiczne w Dataflow Gen2 to nowy tryb, w którym można zezwolić na uruchamianie przepływu danych przez przekazanie wartości parametrów spoza edytora Power Query za pośrednictwem interfejsu Fabric REST API lub natywnych środowisk Fabric. Umożliwia to bardziej dynamiczne środowisko przepływu danych, w którym każde uruchomienie może być wywoływane z różnymi parametrami, które mają wpływ na sposób działania przepływu danych.

Wymagania wstępne

• Dataflow Gen2 z obsługą CI/CD
• Parametry muszą być ustawione w przepływie danych.Dowiedz się więcej na temat ustawiania parametrów zapytania w przepływie danych.

Włączanie trybu parametrów publicznych

Jako właściciel przepływu danych otwórz przepływ danych. Na karcie Narzędzia główne na wstążce wybierz przycisk Opcje .

Wybranie przycisku powoduje otwarcie nowego okna dialogowego Opcje . W menu pionowym wybierz opcję z etykietą Parametry wewnątrz grupy przepływu danych . W sekcji Parametry możesz włączyć opcję "Umożliwiaj odkrywanie i zastępowanie parametrów na czas wykonania", aby włączyć tryb parametrów publicznych.

Wybierz przycisk OK , aby zatwierdzić te zmiany.

Po włączeniu tego trybu w oknie dialogowym Zarządzanie parametrami zostanie wyświetlone powiadomienie z komunikatem "Tryb parametrów publicznych jest włączony" w górnej części okna dialogowego.

Po włączeniu trybu parametru publicznego możesz zapisać przepływ danych.

Przekazywanie niestandardowych wartości parametrów dla uruchomień Dataflow

Tryb parametrów publicznych jest zgodny z definicją parametrów wewnątrz przepływu danych, gdzie istnieje rozróżnienie między parametrami wymaganymi i niewymaganymi.

• Wymagane parametry: jeśli parametr jest ustawiony zgodnie z wymaganiami, aby można było uruchomić przepływ danych, należy przekazać wartość do zadania uruchamiania. Uruchomienie kończy się niepowodzeniem, jeśli nie zostanie przekazana żadna wartość parametru, który jest ustawiony na wymagany.
• Parametry niezgodne z wymaganiami: są one również nazywane parametrami opcjonalnymi i nie trzeba przekazywać żadnej wartości, aby można było wyzwolić przebieg. Jeśli żadna wartość nie zostanie przekazana, bieżąca wartość zdefiniowana w parametrze zostanie użyta do uruchomienia.

Używanie działania Przepływu danych w potokach

Uwaga / Notatka

Zalecamy przeczytanie więcej informacji na temat aktywności przepływu danych w ramach potoków Fabric, aby zrozumieć wszystkie jego możliwości.

Podczas tworzenia potoku w usłudze Fabric możesz użyć aktywności przepływu danych, aby wyzwolić uruchomienie Dataflow Gen2 z obsługą CI/CD, z trybem parametrów publicznych włączonym.

Możesz wybrać przepływ danych, którego chcesz użyć, i ustawić parametry, których chcesz użyć w sekcji Parametry przepływu danych .

W sekcji Parametry przepływu danych można wyświetlić wszystkie parametry dostępne w przepływie danych i wartość domyślną z każdej z sekcji wartości.

Wymagane parametry mają gwiazdkę obok ich nazwy, a parametry opcjonalne nie. Jednocześnie parametry opcjonalne można usunąć z siatki, podczas gdy nie można usunąć wymaganych parametrów, a wartość musi zostać przekazana, aby przepływ danych był uruchamiany.

Możesz wybrać przycisk odświeżania, aby zażądać najnowszych informacji o parametrach z przepływu danych.

Obsługiwane typy parametrów

Wskazówka

Odczytaj i użyj interfejsu API REST parametru Dataflow Discovery. Dokumentacja zawiera wszystkie dostępne typy parametrów i ich oczekiwane wartości, a interfejs API REST umożliwia uzyskanie informacji o parametrach z przepływu danych.

W poniższej tabeli przedstawiono obecnie obsługiwane typy parametrów i link do definicji interfejsu API REST, aby zrozumieć, jakie wartości są oczekiwane przez interfejs API REST.

Typ parametru przepływu danych	Definicja interfejsu API REST
Tekst	DataflowStringParameter
Liczba całkowita (int64)	DataflowIntegerParameter
Liczba dziesiętna	DataflowNumberParameter
Date	DataflowDateParameter
DateTime	DataflowDateTimeParameter
Time	DataflowTimeParameter
DateTimeZone	DataflowDateTimeZoneParameter
Czas trwania	DataflowDurationParameter
Prawda/fałsz	DataflowBooleanParameter

Uwagi i ograniczenia

Poniżej znajduje się lista wszystkich kwestii i ograniczeń związanych z wykorzystaniem trybu parametrów publicznych w usłudze Dataflow Gen2 z ciągłą integracją/ciągłym wdrażaniem:

• Planowanie i wyzwalanie ręczne: przepływy danych z parametrami publicznymi nie mogą być zaplanowane ani wyzwalane ręcznie za pośrednictwem sieci szkieletowej, chyba że nie ustawiono wymaganych parametrów.
• Nieobsługiwana parametryzacja: Parametry, które zmieniają ścieżki zasobów dla źródeł lub miejsc docelowych, nie są obsługiwane. Połączenia są przypisane na stałe do autorskiej ścieżki.
• Odświeżanie przyrostowe: niezgodne z trybem parametrów publicznych.
• Modyfikacja logiki: parametry publiczne umożliwiają użytkownikom dostęp do zastępowania wartości, co potencjalnie powoduje zmianę danych wyjściowych przepływu danych.
• Centrum monitorowania: Centrum monitorowania nie pokazuje wartości parametrów używanych podczas wykonywania.
• Zachowanie scenariuszowe: tylko najnowszy przebieg jest przechowywany w Staging Lakehouse. Użyj zdefiniowanych miejsc docelowych, aby zachować dane.
• Zduplikowane żądania: jeśli te same wartości parametrów są przesyłane wiele razy, tylko pierwsze żądanie jest akceptowane do momentu ukończenia.
• Mapowanie schematu: parametry nie mogą modyfikować mapowań schematu docelowego. Wszystkie mapowania są zgodne z konfiguracją utworzoną. Zapoznaj się z artykułem, aby uzyskać więcej informacji na temat miejsc docelowych danych i ustawień zarządzanych w usłudze Dataflow Gen2.