Configurar parâmetros de tarefa

Os parâmetros de tarefa permitem parametrizar tarefas usando valores que podem ser estáticos, dinâmicos ou definidos por tarefas upstream.

Para obter mais informações sobre o uso de valores dinâmicos, consulte O que é uma referência de valor dinâmico?.

Para obter informações sobre como passar contexto entre tarefas, consulte Usar valores de tarefa para passar informações entre tarefas.

Os ativos configurados por tarefas usam sintaxe diferente para se referir a valores passados como parâmetros. Consulte Configurar e editar tarefas do Databricks.

Observação

Algumas tarefas dão suporte à parametrização, mas não têm campos de parâmetro. Veja o seguinte:

Configurar parâmetros de chave-valor

Configure parâmetros para as seguintes tarefas como pares chave-valor:

  • Notebook
  • Python wheel (somente quando configurada com argumentos de palavra-chave)
  • Consulta SQL, painel herdado ou arquivo
  • Executar trabalho

Os parâmetros de trabalho são enviados automaticamente para tarefas que dão suporte a parâmetros de chave-valor. Um aviso será mostrado na interface do usuário se você tentar adicionar um parâmetro de tarefa com a mesma chave que um parâmetro de trabalho. Consulte Pushdown de parâmetro de trabalho.

Configurar parâmetros de matriz JSON

Configure parâmetros para as seguintes tarefas como uma matriz de cadeias de caracteres formatada em JSON:

  • Script Python
  • Python wheel (somente quando configurada com argumentos posicionais)
  • JAR
  • Spark Submit
  • For each

A tarefa Para cada itera nessa matriz para executar a lógica condicionada na tarefa configurada.

Todos os outros tipos de tarefa passam o conteúdo da matriz formatada em JSON como argumentos, como se os ativos de código configurados estivessem sendo executados na linha de comando.

Os parâmetros de trabalho não são enviados para tarefas que usam matrizes JSON. Você pode fazer referência a parâmetros de trabalho usando referências de valor dinâmico {{job.parameters.<name>}}.

Observação

Os valores de parâmetro de trabalho podem incluir qualquer construção JSON válida. Isso significa que você pode usar referências de valor dinâmico para parâmetros de trabalho para condicionar tarefas.