Konfigurowanie parametrów zadania

  • Artykuł

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:

  1. Kliknij pozycję Ikona przepływów pracy Przepływy pracy na pasku bocznym.
  2. W kolumnie Nazwa kliknij nazwę zadania.
  3. Na pasku bocznym Szczegóły zadania kliknij pozycję Edytuj parametry. Zostanie wyświetlone okno dialogowe Parametry zadania.
  4. Dodawanie lub edytowanie parametrów przy użyciu pól Klucz i Wartość .
  5. Kliknij przycisk , Przenieś do Kosza aby usunąć parametr.
  6. 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.