Passar o contexto sobre a execução do trabalho para a tarefa do trabalho
O senhor pode usar referências de valores dinâmicos para passar o contexto sobre a execução de um trabalho ou tarefa, como o nome do trabalho ou tarefa, o identificador de uma execução ou a hora de início da execução de um trabalho. As referências de valores dinâmicos são variáveis de modelo que são substituídas pelos valores apropriados quando o trabalho é executado. Na execução de um trabalho, a variável de parâmetro tarefa entre chaves duplas é substituída e anexada a um valor de cadeia de caracteres opcional incluído como parte do valor. Por exemplo, para passar um parâmetro chamado MyJobId
com um valor de my-job-6
para qualquer execução do Job ID 6, adicione o seguinte parâmetro de tarefa:
{
"MyJobID": "my-job-{{job.id}}"
}
O conteúdo das chaves duplas não é avaliado como expressões, portanto, o senhor não pode fazer operações ou funções entre chaves duplas.
Os identificadores fornecidos pelo usuário, por exemplo, nomes de tarefa, chave de valor de tarefa ou nomes de parâmetros de trabalho que contenham caracteres especiais devem ser substituídos por caracteres de escape ao redor dos identificadores com marcas de verificação ( ` `
). Somente caracteres alfanuméricos e sublinhados podem ser usados sem escape.
{
"VariableWithSpecialChars": "{{job.parameters.`param$@`}}"
}
Os erros de sintaxe nas referências (por exemplo, uma chave ausente) são ignorados e o valor é tratado como uma cadeia de caracteres literal. Por exemplo, {{my.value}
é passado como a cadeia de caracteres "{{my.value}"
. Entretanto, não é permitido inserir uma referência inválida que pertença a um namespace conhecido (por exemplo, {{job.naem}}
). Uma mensagem de erro será exibida se uma referência inválida pertencente a um namespace conhecido for inserida na interface do usuário.
Após a conclusão de uma tarefa, o senhor pode ver os valores resolvidos dos parâmetros em Parâmetros na página de detalhes da execução.
Referências de valores suportados
Há suporte para as seguintes referências de valores dinâmicos:
Referência |
Descrição |
---|---|
|
O identificador exclusivo atribuído ao trabalho. |
|
O nome do trabalho no momento da execução do trabalho. |
|
O identificador exclusivo atribuído à execução do trabalho. |
|
O número de tentativas de reparo na execução do trabalho atual. |
|
Um valor baseado na hora (no fuso horário UTC) em que a execução do trabalho começou. O valor de retorno é baseado na opção |
|
O valor do parâmetro Job-level com o endereço key |
|
O tipo de acionador da execução do trabalho. Os valores possíveis são |
|
Se um acionador de chegada de arquivo estiver configurado para esse trabalho, o valor do local de armazenamento. |
|
Um valor baseado na hora (no fuso horário UTC) em que a execução do trabalho foi acionada, arredondado para baixo até o minuto mais próximo para trabalhos com um cron programar. O valor de retorno é baseado na opção |
|
O nome da tarefa atual. |
|
O identificador exclusivo da execução da tarefa atual. |
|
O número de vezes que a tarefa atual foi executada (incluindo novas tentativas e reparos). |
|
O caminho do Notebook da tarefa atual do Notebook. |
|
O identificador exclusivo atribuído à execução da tarefa para |
|
O estado do resultado da tarefa |
|
O código de erro da tarefa |
|
O número de vezes que a tarefa |
|
O caminho para o Notebook para a tarefa do Notebook |
|
O valor da tarefa com o key |
|
O identificador exclusivo atribuído ao site workspace. |
|
O URL do site workspace. |
O senhor pode definir essas referências com qualquer tarefa ao criar um trabalho, editar um trabalho ou executar um trabalho com parâmetros diferentes.
O senhor também pode passar parâmetros entre tarefas em um trabalho com valores de tarefa. Veja Share information between tarefa in a Databricks Job.
Opções para valores de data e hora
Use os seguintes argumentos para especificar o valor de retorno das variáveis de parâmetro baseadas em tempo. Todos os valores de retorno são baseados em um registro de data e hora no fuso horário UTC.
Argumento |
Descrição |
---|---|
|
Retorna um dígito de 1 a 7, representando o dia da semana do carimbo de data/hora. |
|
Retorna |
|
Retorna a data no formato ISO. |
|
Retorna a data e a hora no formato ISO. |
|
Retorna a parte do ano do carimbo de data/hora. |
|
Retorna a parte do mês do carimbo de data/hora. |
|
Retorna a parte do dia do carimbo de data/hora. |
|
Retorna a parte da hora do carimbo de data/hora. |
|
Retorna a parte dos minutos do carimbo de data/hora. |
|
Retorna a segunda parte do carimbo de data/hora. |
|
Retorna o registro de data e hora em milissegundos. |
Variáveis de parâmetro obsoletas
As variáveis de parâmetros a seguir estão obsoletas. Embora ainda sejam compatíveis, qualquer novo trabalho ou atualização de um trabalho existente deve usar as [supported value references>(#supported-references). A referência de substituição recomendada está incluída na descrição de cada variável.
Variável |
Descrição |
---|---|
|
O identificador exclusivo atribuído a um trabalho. Em vez disso, use |
|
O identificador exclusivo atribuído a uma execução de tarefa. Em vez disso, use |
|
A data em que a tarefa execução começar. O formato é yyyy-MM-dd no fuso horário UTC. Em vez disso, use |
|
O registro de data e hora do início da execução após o site cluster ter sido criado e estar pronto. O formato é milissegundos desde a época do UNIX no fuso horário UTC, conforme retornado por |
|
O número de novas tentativas de execução de uma tarefa se a primeira tentativa falhar. O valor é 0 para a primeira tentativa e aumenta a cada nova tentativa. Em vez disso, use |
|
O identificador exclusivo atribuído à execução de um trabalho com várias tarefas. Em vez disso, use |
|
O nome exclusivo atribuído a uma tarefa que faz parte de um trabalho com várias tarefas. Em vez disso, use |