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 parametry lub argumenty.

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

• Skonfigurowane wartości zadania, w tym nazwa 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.
• Wartości skonfigurowane przy użyciu parametrów zadania, parametrów zadania lub ustawiania przy użyciu wartości zadań.

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 dynamicznych muszą być definiowane przy użyciu parametrów lub pól, które przekazują kontekst do zadań podrzędnych.

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, udostępniają skrót do wstawiania dostępnych odwołań do wartości dynamicznych. Kliknij pozycję { } , aby wyświetlić tę listę i wstawić ją do podanego pola.

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

Składnia służy {{ }} do używania wartości dynamicznych w definicjach JSON zadania używanych przez interfejs wiersza polecenia usługi Databricks i interfejs API REST.

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

Poniższy przykład przedstawia częściową składnię JSON w celu skonfigurowania parametrów zadania 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 w celu skonfigurowania parametrów zadania notesu przy użyciu odwołania do wartości dynamicznej:

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

Przeglądanie parametrów przebiegu zadania

Po zakończeniu zadania można zobaczyć rozpoznane wartości parametrów w obszarze Parametry na stronie szczegółów przebiegu. 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 ustawić przy użyciu dowolnego zadania. Zobacz Konfigurowanie parametrów zadania.

Można również przekazywać parametry między zadaniami w zadaniu z wartościami zadań. Zobacz Używanie wartości zadań do przekazywania informacji między zadaniami.

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.

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.