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:

  1. Clique em fluxo de trabalho Icon fluxo de trabalho na barra lateral.

  2. Na coluna Nome, clique no nome do cargo.

  3. Na barra lateral de detalhes do siteJob , clique em Edit parameters (Editar parâmetros). A caixa de diálogo Job parameters é exibida.

  4. Adicione ou edite parâmetros usando os campos Chave e Valor.

  5. Clique em Lixo para remover um parâmetro.

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