Pular para o conteúdo principal

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 os pacotes ativos REST API, CLI e Databricks. 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?.

nota

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 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 Lixo 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

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

Os parâmetros Job que são passados automaticamente para a tarefa ficam visíveis na configuração da tarefa na interface do usuário, juntamente com os parâmetros de tarefa configurados.

Para todas as outras tarefas, você pode usar referências de valor dinâmico com a sintaxe {{job.parameters.<name>}} para acessar seus parâmetros de trabalho. Veja O que é uma referência de valor dinâmico?.

important

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 aos 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 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.