Partilhar via


Configurar parâmetros de trabalhos

Este artigo descreve a funcionalidade dos parâmetros de tarefas e a configuração de parâmetros de tarefas através da interface de utilizador do espaço de trabalho Databricks. Também pode adicionar parâmetros de trabalho às definições JSON e YAML usadas com os pacotes REST API, CLI e Automação Declarativa. Veja API de Jobs, Cli de Databricks e O que são Pacotes de Automação Declarativa?.

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 _ - . ou 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:

  1. Na barra lateral do seu workspace do Azure Databricks, clique em Jobs & Pipelines.
  2. Opcionalmente, selecione os filtros Trabalhos e Propriedade de mim .
  3. Clique no link Nome da sua vaga.
  4. Na barra lateral Detalhes do trabalho, clique em Editar parâmetros. A caixa de diálogo Parâmetros do Trabalho é exibida.
  5. Adicione ou edite parâmetros usando os campos Chave e Valor .
  6. Clique no Lixo botão para remover um parâmetro.
  7. 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 .

Otimização de parâmetros de trabalho

Os parâmetros do trabalho são enviados para diferentes tipos de tarefas de formas distintas. Para perceber como são passados e como aceder a eles dentro da tarefa, veja os valores dos parâmetros de acesso de uma tarefa.

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.

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

Você também pode substituir parâmetros de trabalho ao reparar uma tarefa. Consulte Re-executar tarefas falhadas e ignoradas.