Configurar parâmetros do trabalho

Configure os parâmetros de job na UI do workspace Databricks, ou adicione-os às definições JSON e YAML usadas com a API REST, CLI e Declarative Automation Bundles. Consulte API Jobs, CLI do Databricks e O que são Pacotes de Automação Declarativos?.

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.

Chaves de parâmetro de Job só podem conter _ - . ou caracteres alfanuméricos. Valores de parâmetro são definidos como strings ou referências de valor dinâmico. Consulte as Referências de valores dinâmicos.

nota

Um valor de parâmetro de Job pode ser qualquer JSON válido, incluindo matrizes. Para saber como as tarefas consomem parâmetros de matriz JSON, consulte Configurar parâmetros de tarefa.

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 as etapas a seguir:

1. Na barra lateral do site Databricks workspace, clique em Jobs & pipeline .
2. Opcionalmente, selecione os filtros Empregos e de minha propriedade .
3. Clique no link Nome do seu trabalho.
4. Na barra lateral de detalhes do siteJob , clique em Edit parameters (Editar parâmetros ). A caixa de diálogo Job parameters é exibida.
5. Adicione ou edite parâmetros usando os campos Chave e Valor .
6. Clique em para remover um parâmetro.
7. Clique em Salvar para aplicar suas alterações.

nota

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

Os parâmetros Job são atribuídos a diferentes tipos de tarefas de maneiras distintas. Para entender como eles são passados e como acessá-los dentro da tarefa, consulte Acessar valores de parâmetros de uma tarefa.

importante

Para tarefas que aceitam parâmetros key-valor, os parâmetros de Job são automaticamente passados, e se um parâmetro de Job e um parâmetro de tarefa compartilharem uma key, o parâmetro de Job terá precedência. Tarefas que aceitam parâmetros de array JSON não recebem parâmetros de Job automaticamente; referencie-os explicitamente com {{job.parameters.<name>}}. Consulte Configurar parâmetros de tarefa.

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 diferentes configurações.

O senhor também pode substituir os parâmetros do Job ao reparar a execução de um Job. Veja Re-execução falhou e tarefa pulada.