Co to jest odwołanie do wartości dynamicznej?

Odwołania do wartości dynamicznych opisują kolekcję zmiennych dostępnych podczas konfigurowania zadań i zadań. Użyj odwołań do wartości dynamicznych, aby skonfigurować instrukcje warunkowe dla zadań lub przekazać informacje jako parameters lub argumenty.

Odwołania do wartości dynamicznych obejmują takie informacje jak:

• Skonfigurowano values dla zadania, w tym nazwę zadania, nazwy zadań i typ wyzwalacza.
• Wygenerowane metadane dotyczące zadania, w tym identyfikator zadania, identyfikator przebiegu i czas rozpoczęcia uruchomienia zadania.
• Informacje o tylu próbach naprawy wykonanego zadania lub ponawiania próby uruchomienia zadania.
• Stan wyniku określonego zadania.
• Values skonfigurowano przy użyciu zadania parameters, parameters, lub set przy użyciu zadania values.

Używanie odwołań do wartości dynamicznych

Podczas konfigurowania zadań lub zadań należy używać odwołań do wartości dynamicznych. Nie można bezpośrednio odwoływać się do odwołań do wartości dynamicznych z zasobów skonfigurowanych przy użyciu zadań, takich jak notesy, zapytania lub elementy JAR. Odwołania do wartości dynamicznej muszą być zdefiniowane przy użyciu parameters lub pól, które przekazują kontekst zadaniom.

Odwołania do wartości dynamicznych używają podwójnych nawiasów klamrowych ({{ }}). Gdy zadanie lub zadanie zostanie uruchomione, literał ciągu zastępuje odwołanie do wartości dynamicznej. Jeśli na przykład skonfigurujesz następującą parę klucz-wartość jako parametr zadania:

{"job_run_id": "job_{{job.run_id}}"}

Jeśli identyfikator przebiegu to 550315892394120, wartość dla wartości job_run_id jest obliczana na job_550315892394120wartość .

Używanie odwołań do wartości dynamicznych w interfejsie użytkownika zadań

Pola, które akceptują odwołania do wartości dynamicznych, zapewniają skrót do insert dostępnych odwołań do wartości dynamicznych. Kliknij { }, aby wyświetlić tę list i insert ją w podanym polu.

Używanie odwołań do wartości dynamicznych w formacie JSON zadania

Użyj składni {{ }}, aby zastosować dynamiczne values w definicjach JSON zadań stosowanych przez CLI Databricks i REST API.

Zadanie i zadanie parameters mają inną składnię, a składnia parametrów zadania różni się w zależności od typu zadania.

W poniższym przykładzie przedstawiono częściową składnię JSON do skonfigurowania zadania parameters przy użyciu odwołań do wartości dynamicznych:

{
  "parameters": [
    {
      "name": "my_job_id",
      "default": "{{job.id}}"
    },
    {
      "name": "run_date",
      "default": "{{job.start_time.iso_date}}"
    }
  ]
}

Poniższy przykład przedstawia częściową składnię JSON do konfigurowania zadania notatnika parameters przy użyciu dynamicznego odniesienia wartości.

{
  "notebook_task": {
    "base_parameters": {
      "workspace_id": "workspace_{{workspace.id}}",
      "file_arrival_location": "{{job.trigger.file_arrival.location}}"
    }
  }
}

Przeglądanie parameters pod kątem uruchomienia zadania

Po zakończeniu zadania na stronie szczegółów przebiegu można zobaczyć rozpoznany parametr values w obszarze Parameters. Zobacz Wyświetlanie szczegółów uruchomienia zadania.

Obsługiwane odwołania do wartości

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

Te odwołania można set z dowolnym zadaniem. Zobacz Konfigurowanie zadania parameters.

Można również przekazać parameters między zadaniami w zadaniu za pomocą zadania values. Zobacz Użyj zadania values, aby przekazać informacje między zadaniami.

Opcje dotyczące daty i czasu values

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

Przestarzałe odwołania do wartości dynamicznej

Następujące odwołania do wartości dynamicznej są przestarzałe. Zalecane odwołanie zastępcze znajduje się w opisie każdej zmiennej.