O que é uma referência de valor dinâmico?

As referências de valor dinâmico descrevem uma coleção de variáveis disponíveis ao configurar trabalhos e tarefas. Use referências de valor dinâmico para configurar instruções condicionais para tarefas ou para passar informações como parâmetros ou argumentos.

As referências de valor dinâmico incluem informações como:

• Valores configurados para o trabalho, incluindo o nome do trabalho, nomes de tarefas e tipo de gatilho.
• Metadados gerados sobre o trabalho, incluindo o ID do trabalho, o ID de execução e a hora de início da execução do trabalho.
• Informações sobre quantas tentativas de reparo um trabalho fez ou repetiu tentativas de execução de uma tarefa.
• O estado do resultado de uma tarefa especificada.
• Valores configurados usando parâmetros de trabalho, parâmetros de tarefa ou definidos usando valores de tarefa.

Usar referências de valor dinâmico

Use referências de valor dinâmico ao configurar trabalhos ou tarefas. Não é possível fazer referência direta a referências de valor dinâmico de ativos configurados usando tarefas como blocos de anotações, consultas ou JARs. As referências de valores dinâmicos devem ser definidas usando parâmetros ou campos que passam o contexto para as tarefas.

As referências de valores dinâmicos usam chaves duplas ({{ }}). Quando um trabalho ou tarefa é executado, um literal de cadeia de caracteres substitui a referência de valor dinâmico. Por exemplo, se você configurar o seguinte par chave-valor como um parâmetro de tarefa:

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

Se o ID de execução for 550315892394120, o valor for job_run_id avaliado como job_550315892394120.

Usar referências de valor dinâmico na interface do usuário de trabalhos

Os campos que aceitam referências de valor dinâmico fornecem um atalho para inserir referências de valor dinâmico disponíveis. Clique em { } para ver esta lista e inseri-la no campo fornecido.

Usar referências de valor dinâmico em um JSON de trabalho

Use {{ }} a sintaxe para usar valores dinâmicos nas definições JSON de trabalho usadas pela CLI do Databricks e pela API REST.

Os parâmetros de trabalho e tarefa têm sintaxe diferente, e a sintaxe do parâmetro de tarefa varia de acordo com o tipo de tarefa.

O exemplo a seguir mostra a sintaxe JSON parcial para configurar parâmetros de trabalho usando referências de valor dinâmico:

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

O exemplo a seguir mostra a sintaxe JSON parcial para configurar parâmetros de tarefa do bloco de anotações usando uma referência de valor dinâmico:

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

Revisar parâmetros para uma execução de trabalho

Após a conclusão de uma tarefa, você poderá ver os valores de parâmetros resolvidos em Parâmetros na página de detalhes da execução. Consulte Exibir detalhes da execução do trabalho.

Referências de valor suportadas

As seguintes referências de valor dinâmico são suportadas:

Você pode definir essas referências com qualquer tarefa. Consulte Configurar parâmetros da tarefa.

Você também pode passar parâmetros entre tarefas em um trabalho com valores de tarefa. Consulte Usar valores de tarefa para passar informações entre tarefas.

Opções para valores de data e hora

Use os argumentos a seguir para especificar o valor de retorno de variáveis de parâmetro baseadas em tempo. Todos os valores de retorno são baseados em um carimbo de data/hora no fuso horário UTC.

Referências de valor dinâmico preteridas

As seguintes referências de valor dinâmico foram preteridas. A referência de substituição recomendada está incluída na descrição de cada variável.