Předání kontextu úlohy do úloh

Odkazy na dynamické hodnoty můžete použít k předání kontextu o úloze nebo spuštění úkolu, jako je úloha nebo název úkolu, identifikátor spuštění nebo čas spuštění úlohy. Odkazy na dynamické hodnoty jsou proměnné šablony, které se při spuštění úlohy nahradí příslušnými hodnotami. Při spuštění úlohy se nahradí proměnná parametru úkolu obklopená dvojitými složenými složenými závorkami a připojí se k volitelné řetězcové hodnotě zahrnuté jako součást hodnoty. Pokud chcete například předat parametr s MyJobId názvem s hodnotou my-job-6 pro jakékoli spuštění úlohy s ID 6, přidejte následující parametr úlohy:

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

Obsah dvojitých složených závorek se nevyhodnocuje jako výrazy, takže nelze provádět operace ani funkce v dvojitých složených závorkách.

Identifikátory zadané uživatelem, například názvy úkolů, klíče hodnot úkolů nebo názvy parametrů úlohy obsahující speciální znaky, musí být uchvácené kolem identifikátorů s backticks (` `). Bez zapouzdření lze použít pouze alfanumerické znaky a podtržítka.

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

Chyby syntaxe v odkazech (například chybějící složená závorka) se ignorují a hodnota se považuje za literálový řetězec. Například {{my.value} se předává jako řetězec "{{my.value}". Zadání neplatného odkazu, který patří do známého oboru názvů (například {{job.naem}}) není povolený. Pokud je v uživatelském rozhraní zadán neplatný odkaz, který patří do známého oboru názvů, zobrazí se chybová zpráva.

Po dokončení úlohy můžete zobrazit přeložené hodnoty parametrů v části Parametry na stránce podrobností spuštění.

Podporované odkazy na hodnoty

Podporují se následující odkazy na dynamické hodnoty:

Reference	Popis
{{job.id}}	Jedinečný identifikátor přiřazený k úloze.
{{job.name}}	Název úlohy v době spuštění úlohy.
{{job.run_id}}	Jedinečný identifikátor přiřazený ke spuštění úlohy.
{{job.repair_count}}	Počet pokusů o opravu při aktuálním spuštění úlohy.
{{job.start_time.[argument]}}	Hodnota založená na čase (v časovém pásmu UTC), kterou úloha spustila. Vrácená hodnota je založena na argument možnosti. Viz Možnosti pro hodnoty data a času.
{{job.parameters.[name]}}	Hodnota parametru na úrovni úlohy s klíčem [name].
{{job.trigger.type}}	Typ triggeru spuštění úlohy. Možné hodnoty jsou periodic, , onetimerun_job_task, file_arrival, continuous, a table.
{{job.trigger.file_arrival.location}}	Pokud je pro tuto úlohu nakonfigurovaná aktivační událost přijetí souboru, hodnota umístění úložiště.
{{job.trigger.time.[argument]}}	Hodnota založená na čase (v časovém pásmu UTC), kterou se spustila úloha, zaokrouhlená dolů na nejbližší minutu pro úlohy s plánem cron. Vrácená hodnota je založena na argument možnosti. Viz Možnosti pro hodnoty data a času.
{{task.name}}	Název aktuálního úkolu.
{{task.run_id}}	Jedinečný identifikátor aktuálního spuštění úlohy.
{{task.execution_count}}	Počet spuštění aktuálního úkolu (včetně opakovaných pokusů a oprav).
{{task.notebook_path}}	Cesta k poznámkovému bloku aktuálního úkolu poznámkového bloku.
{{tasks.[task_name].run_id}}	Jedinečný identifikátor přiřazený ke spuštění úlohy pro [task_name].
{{tasks.[task_name].result_state}}	Stav výsledku úkolu [task_name]. Možné hodnoty jsou success, failed, excluded, canceled, evicted, timedout, upstream_canceled, upstream_evicted a upstream_failed.
{{tasks.[task_name].execution_count}}	Počet spuštění úlohy [task_name] (včetně opakovaných pokusů a oprav).
{{tasks.[task_name].notebook_path}}	Cesta k poznámkovému bloku pro úkol [task_name]poznámkového bloku .
{{tasks.[task_name].values.[value_name]}}	Hodnota úkolu s klíčem [value_name] nastaveným úkolem [task_name].
{{workspace.id}}	Jedinečný identifikátor přiřazený k pracovnímu prostoru.
{{workspace.url}}	Adresa URL pracovního prostoru.

Tyto odkazy můžete nastavit pomocí libovolného úkolu při vytváření úlohy, úpravě úlohy nebo spuštění úlohy s různými parametry.

Můžete také předat parametry mezi úkoly v úloze s hodnotami úkolů. Viz Sdílení informací mezi úkoly v úloze Azure Databricks.

Možnosti pro hodnoty data a času

Pomocí následujících argumentů určete návratovou hodnotu z proměnných parametrů založených na čase. Všechny návratové hodnoty jsou založeny na časovém razítku v časovém pásmu UTC.

Argument	Popis
iso_weekday	Vrátí číslici od 1 do 7 představující den v týdnu časového razítka.
is_weekday	Vrátí true , pokud časové razítko je v pracovní den.
iso_date	Vrátí datum ve formátu ISO.
iso_datetime	Vrátí datum a čas ve formátu ISO.
year	Vrátí část roku časového razítka.
month	Vrátí část měsíce časového razítka.
day	Vrátí část dne časového razítka.
hour	Vrátí hodinovou část časového razítka.
minute	Vrátí minutovou část časového razítka.
second	Vrátí druhou část časového razítka.
timestamp_ms	Vrátí časové razítko v milisekundách.

Zastaralé proměnné parametrů

Následující proměnné parametrů jsou zastaralé. I když jsou stále podporované, všechny nové úlohy nebo aktualizace stávajících úloh by měly používat podporované odkazy na hodnoty. Doporučený náhradní odkaz je součástí popisu každé proměnné.

Proměnná	Popis
{{job_id}}	Jedinečný identifikátor přiřazený k úloze. Místo toho použijte job.id.
{{run_id}}	Jedinečný identifikátor přiřazený ke spuštění úlohy. Místo toho použijte task.run_id.
{{start_date}}	Datum spuštění úlohy. Formát je rrrr-MM-dd v časovém pásmu UTC. Místo toho použijte job.start_time.[argument].
{{start_time}}	Časové razítko spuštění spuštění po vytvoření a dokončení clusteru. Formát je milisekund, protože systém UNIX epocha v časovém pásmu UTC, jak je vráceno System.currentTimeMillis(). Místo toho použijte job.start_time.[format].
{{task_retry_count}}	Počet opakovaných pokusů, které se pokusily spustit úlohu, pokud první pokus selže. Hodnota je 0 pro první pokus a zvýší se při každém opakování. Místo toho použijte task.execution_count.
{{parent_run_id}}	Jedinečný identifikátor přiřazený ke spuštění úlohy s více úkoly. Místo toho použijte job.run_id.
{{task_key}}	Jedinečný název přiřazený k úkolu, který je součástí úlohy s více úkoly. Místo toho použijte task.name.