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 transmitir 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, os nomes das tarefas e o tipo de gatilho.
• Metadados gerados sobre o trabalho, incluindo a ID do trabalho, a 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 repetições de tentativas de uma tarefa foram executadas.
• 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 diretamente de ativos configurados usando tarefas como notebooks, consultas ou JARs. As referências de valor dinâmico devem ser definidas usando parâmetros ou campos que transmitem contexto para tarefas.

As referências de valor dinâmico 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 de chave-valor como um parâmetro de tarefa:

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

Se a ID de execução for 550315892394120, o valor de job_run_id será 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 essa 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 em definições JSON de trabalho usadas pela CLI do Databricks e pela API REST.

Os parâmetros de trabalho e tarefa têm sintaxe diferentes, 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 de notebook 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 resolvidos do parâmetro em Parâmetros na página detalhes da execução. Confira Exibir detalhes da execução do trabalho.

Referências de valores com suporte

Há suporte para as seguintes referências de valores dinâmicos:

Você pode definir essas referências com qualquer tarefa. Confira Configurar os parâmetros de tarefa.

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

Opções para valores de data e hora

Use os seguintes argumentos para especificar o valor de retorno das variáveis de parâmetro baseadas em tempo. Todos os valores retornados 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 valores dinâmicos estão preteridas: A referência de substituição recomendada está incluída na descrição de cada variável.