Configurar parâmetros do trabalho
Este artigo descreve a funcionalidade dos parâmetros do trabalho e a configuração dos parâmetros do trabalho com a UI Databricks workspace . O senhor também pode adicionar parâmetros de trabalho às definições JSON e YAML usadas com REST API, CLI e DABs. Veja Jobs API, What is the Databricks CLI?, e What are Databricks ativo Bundles?
O que são parâmetros de trabalho?
Job são parâmetros key-value que permitem que o senhor parametrize o Job com default valores estáticos ou dinâmicos. Opcionalmente, o senhor pode substituir os parâmetros configurados em um Job ao acionar uma nova execução. Veja como executar um trabalho com parâmetros diferentes.
Job A chave de parâmetro só pode conter _ - .
ou caracteres alfanuméricos. Os valores dos parâmetros são definidos como strings ou referências de valores dinâmicos. Consulte O que é uma referência de valor dinâmico?.
Observação
O senhor pode usar qualquer JSON válido como valor de parâmetro. Por exemplo, o tipo de tarefa For each
pode analisar listas como as seguintes:
[1, 2, 3]
['a', 'b', 'c']
Adicionar ou editar parâmetros do Job
Use a caixa de diálogo Job parameters para adicionar novos parâmetros, editar a chave e os valores dos parâmetros existentes ou excluir parâmetros.
Para editar parâmetros com a interface do usuário workspace, selecione um trabalho existente usando os seguintes passos:
Clique em fluxo de trabalho na barra lateral.
Na coluna Nome, clique no nome do cargo.
Na barra lateral de detalhes do siteJob , clique em Edit parameters (Editar parâmetros). A caixa de diálogo Job parameters é exibida.
Adicione ou edite parâmetros usando os campos Chave e Valor.
Clique em para remover um parâmetro.
Clique em Salvar para aplicar suas alterações.
Observação
Clique em {} para listar as referências de valores dinâmicos disponíveis. Selecione uma opção na lista para inseri-la no campo Valor.
Job parâmetro pushdown
Job são automaticamente enviados como parâmetros de valor keypara todas as tarefas que aceitam parâmetros de valor key, que incluem os seguintes tipos de tarefa:
Notebook
Python wheel (somente quando configurado com argumentos de palavra-chave)
Consulta SQL, painel de controle herdado ou arquivo
Executar job
Job Os parâmetros passados para a tarefa são visíveis na configuração da tarefa na UI junto com os parâmetros configurados da tarefa.
Importante
Job têm precedência sobre os parâmetros de tarefa. Se um parâmetro de trabalho e um parâmetro de tarefa tiverem o mesmo key, o parâmetro de trabalho substituirá o parâmetro de tarefa.
Referências de valores dinâmicos a parâmetros do Job
Todas as tarefas que aceitam referências de valores dinâmicos podem acessar os parâmetros do Job.
Use a referência de valor dinâmico {{job.parameters.<name>}}
, substituindo <name>
pelo key
que identifica o parâmetro.
Executar um job com parâmetros diferentes
O senhor pode substituir os parâmetros configurados do Job ou adicionar novos parâmetros ao executar um Job com parâmetros diferentes. Veja como executar um trabalho com parâmetros diferentes.
O senhor também pode substituir os parâmetros do trabalho ao reparar a execução de um trabalho. Veja Re-execução falhou e tarefa pulada.