Configurar parâmetros de trabalhos
Este artigo descreve a funcionalidade do parâmetro de trabalho e a configuração de parâmetros de trabalho com a interface do usuário do espaço de trabalho Databricks. Você também pode adicionar parâmetros de trabalho às definições JSON e YAML usadas com a API REST, CLI e DABs. Consulte API de trabalhos, O que é a CLI do Databricks?, e O que são pacotes de ativos Databricks?.
O que são parâmetros de trabalho?
Os parâmetros de trabalho são pares chave-valor que permitem parametrizar trabalhos com valores estáticos ou dinâmicos padrão. Opcionalmente, você pode substituir parâmetros configurados em um trabalho ao acionar uma nova execução. Consulte Executar um trabalho com parâmetros diferentes.
As chaves de parâmetro de trabalho só podem conter _ - . caracteres alfanuméricos. Os valores dos parâmetros são definidos como cadeias de caracteres ou referências de valores dinâmicos. Consulte O que é uma referência de valor dinâmico?.
Nota
Você pode usar qualquer JSON válido como um valor de parâmetro. Por exemplo, o For each tipo de tarefa pode analisar listas como as seguintes:
[1, 2, 3]
['a', 'b', 'c']
Adicionar ou editar parâmetros de trabalho
Use a caixa de diálogo Parâmetros do trabalho para adicionar novos parâmetros, editar chaves e valores de parâmetros existentes ou excluir parâmetros.
Para editar parâmetros com a interface do usuário do espaço de trabalho, selecione um trabalho existente usando as seguintes etapas:
- Clique em
Fluxos de trabalho na barra lateral. - Na coluna Nome, clique no nome do trabalho.
- Na barra lateral Detalhes do trabalho, clique em Editar parâmetros. A caixa de diálogo Parâmetros do trabalho é exibida.
- Adicione ou edite parâmetros usando os campos Chave e Valor .
- Clique no
botão para remover um parâmetro. - Clique em Guardar para aplicar as suas alterações.
Nota
Clique em { } para listar as referências de valor dinâmico disponíveis. Selecione uma opção na lista para inseri-la no campo Valor .
Pushdown de parâmetro de trabalho
Os parâmetros de trabalho são automaticamente empurrados para baixo como parâmetros chave-valor para todas as tarefas que aceitam parâmetros chave-valor, que incluem os seguintes tipos de tarefas:
- 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 passados para tarefas são visíveis na configuração da tarefa na interface do usuário ao lado dos parâmetros de tarefa configurados.
Importante
Os parâmetros de trabalho têm precedência sobre os parâmetros de tarefa. Se um parâmetro job e um parâmetro task tiverem a mesma chave, o parâmetro job substituirá o parâmetro task.
Referências de valor dinâmico a parâmetros de trabalho
Todas as tarefas que aceitam referências de valor dinâmico podem acessar parâmetros de trabalho.
Use a referência {{job.parameters.<name>}}de valor dinâmico , substituindo <name> pelo key que identifica o parâmetro.
Executar um trabalho com parâmetros diferentes
Você pode substituir parâmetros de trabalho configurados ou adicionar novos parâmetros ao executar um trabalho com parâmetros diferentes. Consulte Executar um trabalho com parâmetros diferentes.
Você também pode substituir parâmetros de trabalho ao reparar uma execução de trabalho. Consulte Executar novamente tarefas com falha e ignoradas.