Przekazywanie kontekstu zadania jest uruchamiane w zadaniach zadań podrzędnych

Można użyć odwołań wartości dynamicznych , aby przekazać kontekst dotyczący zadania lub uruchomienia zadania, takiego jak zadanie lub nazwa zadania, identyfikator przebiegu lub godzina rozpoczęcia uruchomienia zadania. Odwołania do wartości dynamicznych to zmienne szablonowe, które są zastępowane odpowiednimi wartościami po uruchomieniu zadania zadania. Po uruchomieniu zadania zmienna parametru zadania otoczona podwójnymi nawiasami klamrowymi jest zastępowana i dołączana do opcjonalnej wartości ciągu uwzględnionej jako część wartości. Aby na przykład przekazać parametr o nazwie MyJobId z wartością my-job-6 dla dowolnego przebiegu zadania o identyfikatorze 6, dodaj następujący parametr zadania:

{
  "MyJobID": "my-job-{{job.id}}"
}

Zawartość podwójnych nawiasów klamrowych nie jest obliczana jako wyrażenia, więc nie można wykonywać operacji ani funkcji w nawiasach klamrowych z podwójnymi klamrami.

Identyfikatory udostępniane przez użytkownika, na przykład nazwy zadań, klucze wartości zadania lub nazwy parametrów zadania zawierające znaki specjalne muszą być przekazywane przez otaczanie identyfikatorów za pomocą backticks (` `). Bez ucieczki można używać tylko znaków alfanumerycznych i podkreślenia.

{
  "VariableWithSpecialChars": "{{job.parameters.`param$@`}}"
}

Błędy składni w odwołaniach (na przykład brak nawiasu klamrowego) są ignorowane, a wartość jest traktowana jako ciąg literału. Na przykład {{my.value} parametr jest przekazywany jako ciąg "{{my.value}". Jednak wprowadzenie nieprawidłowego odwołania należącego do znanej przestrzeni nazw (na przykład {{job.naem}}) nie jest dozwolone. Zostanie wyświetlony komunikat o błędzie, jeśli w interfejsie użytkownika zostanie wprowadzone nieprawidłowe odwołanie należące do znanej przestrzeni nazw.

Po zakończeniu zadania można zobaczyć rozpoznane wartości parametrów w obszarze Parametry na stronie szczegółów przebiegu.

Obsługiwane odwołania do wartości

Obsługiwane są następujące odwołania do wartości dynamicznych:

Odwołanie	opis
{{job.id}}	Unikatowy identyfikator przypisany do zadania.
{{job.name}}	Nazwa zadania w momencie uruchomienia zadania.
{{job.run_id}}	Unikatowy identyfikator przypisany do przebiegu zadania.
{{job.repair_count}}	Liczba prób naprawy w bieżącym uruchomieniu zadania.
{{job.start_time.[argument]}}	Wartość oparta na godzinie (w strefie czasowej UTC), którą uruchomiono zadanie. Wartość zwracana jest oparta na argument opcji . Zobacz Opcje wartości daty i godziny.
{{job.parameters.[name]}}	Wartość parametru poziomu zadania z kluczem [name].
{{job.trigger.type}}	Typ wyzwalacza przebiegu zadania. Możliwe wartości to periodic, , onetime, run_job_taskfile_arrival, , continuousi table.
{{job.trigger.file_arrival.location}}	Jeśli dla tego zadania skonfigurowano wyzwalacz przybycia pliku, wartość lokalizacji przechowywania.
{{job.trigger.time.[argument]}}	Wartość oparta na czasie (w strefie czasowej UTC), o którą zostało wyzwolone uruchomienie zadania, zaokrąglona w dół do najbliższej minuty dla zadań z harmonogramem cron. Wartość zwracana jest oparta na argument opcji . Zobacz Opcje wartości daty i godziny.
{{task.name}}	Nazwa bieżącego zadania.
{{task.run_id}}	Unikatowy identyfikator bieżącego przebiegu zadania.
{{task.execution_count}}	Liczba uruchomień bieżącego zadania (w tym ponownych prób i napraw).
{{task.notebook_path}}	Ścieżka notesu bieżącego zadania notesu.
{{tasks.[task_name].run_id}}	Unikatowy identyfikator przypisany do uruchomienia zadania dla elementu [task_name].
{{tasks.[task_name].result_state}}	Stan wyniku zadania [task_name]. Możliwe wartości to success, failed, excluded, canceled, evicted, timedout, upstream_canceled, upstream_evicted i upstream_failed.
{{tasks.[task_name].execution_count}}	Liczba uruchomień zadania [task_name] (w tym ponownych prób i napraw).
{{tasks.[task_name].notebook_path}}	Ścieżka do notesu dla zadania [task_name]notesu .
{{tasks.[task_name].values.[value_name]}}	Wartość zadania z kluczem [value_name] ustawionym przez zadanie [task_name].
{{workspace.id}}	Unikatowy identyfikator przypisany do obszaru roboczego.
{{workspace.url}}	Adres URL obszaru roboczego.

Te odwołania można ustawić przy użyciu dowolnego zadania podczas tworzenia zadania, edytowania zadania lub uruchamiania zadania z różnymi parametrami.

Można również przekazywać parametry między zadaniami w zadaniu z wartościami zadań. Zobacz Udostępnianie informacji między zadaniami w zadaniu usługi Azure Databricks.

Opcje wartości daty i godziny

Użyj następujących argumentów, aby określić wartość zwracaną ze zmiennych parametrów opartych na czasie. Wszystkie wartości zwracane są oparte na znaczniku czasu w strefie czasowej UTC.

Argument	opis
iso_weekday	Zwraca cyfrę z zakresu od 1 do 7, reprezentującą dzień tygodnia znacznika czasu.
is_weekday	Zwraca wartość true , jeśli sygnatura czasowa jest w dni powszednie.
iso_date	Zwraca datę w formacie ISO.
iso_datetime	Zwraca datę i godzinę w formacie ISO.
year	Zwraca część roku znacznika czasu.
month	Zwraca część znacznika czasu w miesiącu.
day	Zwraca część dnia znacznika czasu.
hour	Zwraca część godziny znacznika czasu.
minute	Zwraca część minuty znacznika czasu.
second	Zwraca drugą część znacznika czasu.
timestamp_ms	Zwraca znacznik czasu w milisekundach.

Przestarzałe zmienne parametrów

Następujące zmienne parametrów są przestarzałe. Mimo że są one nadal obsługiwane, wszystkie nowe zadania lub aktualizacje istniejących zadań powinny używać obsługiwanych odwołań do wartości. Zalecane odwołanie zastępcze znajduje się w opisie każdej zmiennej.

Zmienna	opis
{{job_id}}	Unikatowy identyfikator przypisany do zadania. Użycie w zamian parametru job.id.
{{run_id}}	Unikatowy identyfikator przypisany do przebiegu zadania. Użycie w zamian parametru task.run_id.
{{start_date}}	Data uruchomienia zadania. Format to yyyy-MM-dd w strefie czasowej UTC. Użycie w zamian parametru job.start_time.[argument].
{{start_time}}	Sygnatura czasowa rozpoczęcia wykonywania przebiegu po utworzeniu i dokonaniu gotowości klastra. Format jest milisekundowy, ponieważ system UNIX epokę w strefie czasowej UTC, jak zwraca wartość .System.currentTimeMillis() Użycie w zamian parametru job.start_time.[format].
{{task_retry_count}}	Liczba ponownych prób, które próbowano uruchomić zadanie, jeśli pierwsza próba zakończy się niepowodzeniem. Wartość to 0 dla pierwszej próby i zwiększa się wraz z każdą ponowną próbą. Użycie w zamian parametru task.execution_count.
{{parent_run_id}}	Unikatowy identyfikator przypisany do uruchomienia zadania z wieloma zadaniami. Użycie w zamian parametru job.run_id.
{{task_key}}	Unikatowa nazwa przypisana do zadania, które jest częścią zadania z wieloma zadaniami. Użycie w zamian parametru task.name.