Partilhar via

Configurar parâmetros de tarefa

  • Artigo

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

Para obter informações sobre como usar 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.

Nota

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

Configurar parâmetros chave-valor

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

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

Os parâmetros de trabalho são automaticamente empurrados para tarefas que suportam 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 de 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 do Python
  • Roda Python (apenas quando configurada com argumentos posicionais)
  • JAR
  • Enviar faísca
  • Para cada

O Para cada tarefa itera sobre essa matriz para executar a lógica condicionalizada na tarefa configurada.

Todos os outros tipos de tarefas passam as contends da matriz formatada em JSON como argumentos como se os ativos de código configurados estivessem sendo executados a partir da linha de comando.

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

Nota

Os valores dos parâmetros 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 condicionalizar tarefas.