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żna również dodać parametry zadania do definicji JSON i YAML używanych z interfejsem API REST, interfejsem wiersza polecenia i pakietami zasobów usługi Databricks. Zobacz Jobs API, Co to jest Databricks CLI?, i Co to są Databricks Asset Bundles?.

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 uruchamiania nowej sesji. Zobacz Uruchom zadanie z różnymi parametrami.

Klucze parametrów zadania mogą zawierać tylko _ - . lub znaki alfanumeryczne. 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 For each może analizować listy, 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:

1. Na pasku bocznym obszaru roboczego usługi Azure Databricks kliknij pozycję Zadania i potoki.
2. Opcjonalnie wybierz filtry Zadania i Należące do mnie .
3. Kliknij link Nazwa swojego zadania.
4. Na pasku bocznym Szczegóły zadania kliknij pozycję Edytuj parametry. Pojawia się okno dialogowe parametrów zadania.
5. Dodaj lub edytuj parametry, używając pól Klucz i Wartość.
6. Kliknij , aby usunąć parametr.
7. W celu zastosowania zmian, kliknij Zapisz.

Uwaga

Kliknij { }, aby wyświetlić listę dostępnych odwołań do wartości dynamicznych. Wybierz opcję z listy, aby wstawić ją do pola Wartość.

Przesunięcie parametru zadania w dół

Parametry zadania są automatycznie przekazywane jako parametry klucz-wartość do wszystkich zadań akceptujących takie parametry, co obejmuje następujące typy zadań:

• Notatnik
• Koło języka Python (tylko w przypadku skonfigurowania przy użyciu argumentów słów kluczowych)
• Zapytanie SQL, starszy pulpit nawigacyjny lub plik
• Uruchom zadanie

Parametry zadań przekazywane do zadań są widoczne w konfiguracji zadań w interfejsie użytkownika, wraz ze skonfigurowanymi parametrami zadań.

Ważne

Parametry pracy mają pierwszeństwo przed parametrami zadania. Jeśli parametr zadania i parametr zlecenia mają identyczny klucz, parametr zadania zastępuje parametr zlecenia.

Odwołania dynamicznych wartości 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>key identyfikującym 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 ustawieniami.

Można również zastąpić parametry zadania podczas naprawy jego uruchomienia. Zobacz Ponowne uruchamianie nieudanych i pominiętych zadań.