Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Parametry umożliwiają przekazywanie wartości do zadania i jego zadań oraz odwoływanie się do wartości między zadaniami. W tym artykule przedstawiono typy parametrów dostępne w zadaniach lakeflow i sposób ich konfigurowania w interfejsie użytkownika. Należy również zaktualizować zasoby kodu źródłowego skonfigurowane jako zadania do odwołowania się do parametrów. Odwołania do parametrów różnią się w zależności od języka i typu zadania. Zobacz jak uzyskać dostęp do wartości parametrów z zadania.
Poniżej przedstawiono podstawowe pojęcia dotyczące zrozumienia parametrów zadań:
- Parametr pracy: para klucz-wartość zdefiniowana na poziomie pracy i przekazywana do zadań. Zobacz Konfigurowanie parametrów zadania.
- Parametr zadania: para klucz-wartość lub tablica JSON zdefiniowana na poziomie zadania. Zobacz Konfigurowanie parametrów zadania.
- Odwołania do wartości dynamicznych: składnia odwołująca się do warunków zadania, metadanych i parametrów podczas konfigurowania zadań. Zobacz Odwołania do wartości dynamicznych.
- Wartości zadań: składnia do przechwytywania i odwoływania się do wartości generowanych w trakcie wykonywania zadań. Zobacz Używanie wartości zadań do przekazywania informacji między zadaniami.
- Uzyskiwanie dostępu do wartości parametrów w kodzie: jak odczytywać wartości parametrów z kodu zadania według typu zadania. Zobacz jak uzyskać dostęp do wartości parametrów z zadania.
Uwaga
Aby przekazać konfigurację specyficzną dla wdrożenia do kodu aplikacji jako zmienne środowiskowe zamiast parametrów, użyj zmiennych środowiskowych dla zadań bezserwerowych. Zobacz Konfigurowanie zmiennych środowiskowych dla zadań bezserwerowych.
Co można zrobić za pomocą parametrów
Dodaj parametry do prac i zadań dla zaawansowanych przypadków użycia, w tym następujących:
- Dodaj rozszerzalną logikę do zasobów kodu.
- Warunkuj uruchomienia.
- Odwołuj się do typowych parametrów w wielu zadaniach.
- Użyj informacji wygenerowanych w jednym zadaniu w innym zadaniu.
- Odwołanie do metadanych i informacji o stanie podczas uruchamiania zadania.
Parametry zadania a parametry czynności
Parametry zadania to pary klucz-wartość zdefiniowane na poziomie zadania. Ustawienia domyślne parametrów zadania można zastąpić po uruchomieniu zadania z innymi parametrami lub wyzwoleniu uruchomienia zadania za pomocą interfejsu API REST. Parametry zadania są wypychane do zadań, które używają parametrów klucz-wartość. Inne zadania mogą odwoływać się do parametrów zadania przy użyciu odwołań do wartości dynamicznych.
Uwaga
Każdy użytkownik z uprawnieniem CAN MANAGE RUN lub wyższym dla zadania może nadpisać wartości parametrów zadania podczas ręcznego uruchomienia za pomocą opcji Uruchom teraz z innymi parametrami. Domyślna wartość parametru nie jest kontrolą zabezpieczeń. Aby zapobiec zmianom, ogranicz uprawnienia zadania.
Parametry zadania to pary klucz-wartość lub tablice JSON zdefiniowane na poziomie zadania. Każdy typ zadania przekazuje wartości zadań do skonfigurowanych zasobów kodu inaczej. Na przykład zadania notesu używają modułu podrzędnego dbutils.widgets , podczas gdy skrypty języka Python przekazują wartości jako argumenty do skryptu tak, jakby były wywoływane z wiersza polecenia. Podrzędne zadania mogą odwoływać się do parametrów zadań nadrzędnych przy użyciu odwołań do wartości dynamicznych. Zobacz jak uzyskać dostęp do wartości parametrów z zadania.
Uwaga
Niektóre zadania nie mają dedykowanego pola Parametry , ale umożliwiają odwołania do wartości zadań lub odwołania do wartości dynamicznych w innych polach. Zobacz Przykłady sparametryzowanych poleceń dbt i Dodaj logikę rozgałęziania do zadania za pomocą zadania If/else.
Tworzenie przepływów pracy przy użyciu wartości dynamicznych
Parametry zadania ustawione przy użyciu wartości statycznych można zastąpić tylko przez zaktualizowanie definicji zadania. Ustawienie wartości statycznej dla parametru zadania polega tylko na skonfigurowaniu wartości domyślnej, którą można zastąpić podczas uruchamiania teraz przy użyciu różnych parametrów lub wyzwalania uruchomienia zadania przy użyciu interfejsu API REST.
Użyj odwołań do wartości dynamicznych podczas definiowania parametrów zadania w celu zaimplementowania wzorców, takich jak:
- Użyj parametru zadania jako
output_tabledla jednego zadania i jakoinput_tabledla drugiego. - Przechwyć dane wyjściowe zapytania notesu jako listę i przetwórz je w pętli w zadaniu For each.
- Tworzenie logiki rozwidlania na podstawie liczby przetworzonych rekordów przy użyciu zadania If/else condition.
- Zapoznaj się z parametrami z innych zadań.