Konfigurowanie parametrów zadania
W tym artykule opisano funkcje parametrów zadania i konfigurowanie parametrów zadania przy użyciu interfejsu użytkownika obszaru roboczego usługi Databricks. Możesz również dodać parametry zadania do definicji JSON i YAML używanych z interfejsem API REST, interfejsem wiersza polecenia i bazami DAB. Zobacz Interfejs API zadań, Co to jest interfejs wiersza polecenia usługi Databricks?, i Co to są pakiety zasobów usługi Databricks?.
Co to są parametry zadania?
Parametry zadania to pary klucz-wartość, które umożliwiają sparametryzowanie zadań z domyślnymi wartościami statycznymi lub dynamicznymi. Opcjonalnie można zastąpić parametry skonfigurowane w zadaniu podczas wyzwalania nowego przebiegu. Zobacz Uruchamianie zadania z różnymi parametrami.
Klucze parametrów zadania mogą zawierać _ - . tylko znaki alfanumeryczne lub . Wartości parametrów są ustawiane jako ciągi lub odwołania do wartości dynamicznych. Zobacz Co to jest odwołanie do wartości dynamicznej?.
Uwaga
Możesz użyć dowolnego prawidłowego kodu JSON jako wartości parametru. Na przykład typ zadania może analizować listy, For each takie jak:
[1, 2, 3]
['a', 'b', 'c']
Dodawanie lub edytowanie parametrów zadania
Użyj okna dialogowego Parametry zadania, aby dodać nowe parametry, edytować istniejące klucze parametrów i wartości lub usunąć parametry.
Aby edytować parametry za pomocą interfejsu użytkownika obszaru roboczego, wybierz istniejące zadanie, wykonując następujące kroki:
- Kliknij pozycję
Przepływy pracy na pasku bocznym. - W kolumnie Nazwa kliknij nazwę zadania.
- Na pasku bocznym Szczegóły zadania kliknij pozycję Edytuj parametry. Zostanie wyświetlone okno dialogowe Parametry zadania.
- Dodawanie lub edytowanie parametrów przy użyciu pól Klucz i Wartość .
- Kliknij przycisk ,
aby usunąć parametr. - W celu zastosowania zmian, kliknij Zapisz.
Uwaga
Kliknij pozycję { } , aby wyświetlić listę dostępnych odwołań do wartości dynamicznych. Wybierz opcję z listy, aby wstawić ją do pola Wartość .
Wypychanie parametru zadania
Parametry zadania są automatycznie wypychane jako parametry klucz-wartość do wszystkich zadań, które akceptują parametry klucz-wartość, które obejmują następujące typy zadań:
- Notes
- Koło języka Python (tylko w przypadku skonfigurowania przy użyciu argumentów słów kluczowych)
- Zapytanie SQL, starszy pulpit nawigacyjny lub plik
- Uruchamianie zadania
Parametry zadania przekazywane do zadań są widoczne w konfiguracji zadania w interfejsie użytkownika wraz ze skonfigurowanymi parametrami zadania.
Ważne
Parametry zadania mają pierwszeństwo przed parametrami zadania. Jeśli parametr zadania i parametr zadania mają ten sam klucz, parametr zadania zastępuje parametr zadania.
Odwołania wartości dynamicznej do parametrów zadania
Wszystkie zadania, które akceptują odwołania do wartości dynamicznych, mogą uzyskiwać dostęp do parametrów zadania.
Użyj odwołania {{job.parameters.<name>}}do wartości dynamicznej , zastępując <name> element parametrem key , który identyfikuje parametr .
Uruchamianie zadania z różnymi parametrami
Parametry skonfigurowanego zadania można zastąpić lub dodać nowe podczas uruchamiania zadania z różnymi parametrami. Zobacz Uruchamianie zadania z różnymi parametrami.
Parametry zadania można również zastąpić podczas naprawiania uruchomienia zadania. Zobacz Ponowne uruchamianie nie powiodło się i pominięto zadania.