Nó de parâmetros - DataWorks: Central de Documentação do Alibaba Cloud

Um nó de parâmetros é um nó virtual que gerencia parâmetros em um fluxo de trabalho e os transmite entre nós de tarefa. Ele oferece suporte a parâmetros constantes, parâmetros variáveis e parâmetros de passagem de nós upstream. Os nós que precisam de parâmetros podem estabelecer uma dependência no nó de parâmetros para acessá-los diretamente.

Visão geral

Um nó de parâmetros é um nó virtual que não executa tarefas de computação de dados nem produz dados. Seu uso principal é a transmissão de parâmetros entre nós e o gerenciamento centralizado de parâmetros.

Transmitir parâmetros entre nós

Quando um nó downstream precisa de parâmetros de saída de vários nós upstream em diversos níveis, consolide-os em um nó de parâmetros. Adicione todos os parâmetros necessários ao nó de parâmetros e, em seguida, defina o nó downstream para depender dele diretamente.

Na figura acima, o nó Sq_MySQL_G precisa dos parâmetros de saída dos nós Sq_MySQL_B e Sq_MySQL_E. Use um nó de parâmetros como nó downstream tanto para Sq_MySQL_B quanto para Sq_MySQL_E. Adicione todos os parâmetros necessários para Sq_MySQL_G ao nó de parâmetros. Depois, defina Sq_MySQL_G como um nó downstream do nó de parâmetros para receber seus parâmetros de saída. Dessa forma, Sq_MySQL_G obtém os parâmetros de Sq_MySQL_B e Sq_MySQL_E por meio do nó de parâmetros.
Gerenciamento centralizado de parâmetros

Quando os nós de tarefa downstream em um fluxo de trabalho precisam de determinados parâmetros constantes ou variáveis, adicione todos eles a um único nó de parâmetros. Os nós downstream passam a depender diretamente do nó de parâmetros, centralizando o gerenciamento de parâmetros do fluxo de trabalho.

Na figura acima, os nós Sq2_MySQL_A, Sq2_MySQL_C, Sq2_MySQL_D, Sq2_MySQL_E e Sq2_MySQL_F precisam de parâmetros. Use um nó de parâmetros para obter os parâmetros de saída dos nós upstream e configure os parâmetros variáveis ou constantes necessários. Esse nó de parâmetros serve então como dependência upstream para esses nós.

Pré-requisitos

O usuário RAM que você usará deve estar adicionado ao seu workspace.

Para usar um usuário RAM no desenvolvimento de tarefas, adicione o usuário RAM ao seu workspace como membro e atribua a função Develop ou Workspace Administrator a ele. A função Workspace Administrator concede mais permissões do que o necessário. Tenha cuidado ao atribuir a função Workspace Administrator. Para obter mais informações sobre como adicionar um membro e atribuir funções, consulte Add members to a workspace.
Um grupo de recursos serverless deve estar associado ao seu workspace. Para obter mais informações, consulte os tópicos no diretório Use serverless resource groups.
Antes de configurar um nó de parâmetros, crie um. Para obter mais informações, consulte crie nodes for a scheduling workflow.

Nota

Para referenciar parâmetros de um nó de parâmetros, o nó de tarefa deve ser seu nó downstream direto e definir o nó de parâmetros como dependência upstream.

Etapa 1: Configurar o nó de parâmetros

É possível criar parâmetros constantes, parâmetros variáveis e variáveis de passagem em um nó de parâmetros. As seções a seguir descrevem como configurar cada tipo.

Adicionar um parâmetro constante

Um parâmetro constante possui um valor fixo configurado diretamente no nó de parâmetros.

Abra o editor do nó de parâmetros e clique no botão de adicionar parâmetro no canto superior esquerdo para adicionar um parâmetro.

Configure o parâmetro constante:

Parâmetro	Descrição
Nome do parâmetro	Um nome de parâmetro personalizado. Nota Esse nome é usado para seleção quando os nós downstream adicionam parâmetros.
Tipo de parâmetro	Constante.
Valor	Um valor constante personalizado.
Descrição	Uma descrição personalizada do parâmetro.

Após configurar o parâmetro constante, clique em Save na coluna Actions para salvar o parâmetro.

Adicionar um parâmetro variável

Se o valor do parâmetro for uma variável, como uma variável de hora do sistema, defina o tipo de parâmetro como variável ao adicioná-lo.

Abra o editor do nó de parâmetros e clique no botão de adicionar parâmetro no canto superior esquerdo para adicionar um parâmetro.

Configure o parâmetro variável:

Parâmetro	Descrição
Nome do parâmetro	Um nome de parâmetro personalizado. Nota Esse nome é usado para seleção quando os nós downstream adicionam parâmetros.
Tipo de parâmetro	Variável.
Valor	Um valor variável personalizado. Nota Para obter mais informações sobre parâmetros variáveis, consulte configure scheduling parameters.
Descrição	Uma descrição personalizada do parâmetro.

Após configurar o parâmetro variável, clique em Save na coluna Actions para salvar o parâmetro.

Adicionar um parâmetro de variável de passagem

Uma variável de passagem transmite parâmetros de saída de nós upstream para nós downstream. Seu valor pode ser definido como qualquer parâmetro de saída dos nós de dependência upstream especificados nas configurações de agendamento do nó de parâmetros.

Abra o editor do nó de parâmetros e clique em schedule settings no lado direito. Em Scheduling Settings > Scheduling Dependency > Node dependency configuration, clique em Add Dependency e configure o nó cujos parâmetros você deseja transmitir como uma dependência upstream.
Após configurar a dependência, alterne para Scheduling Parameters e clique em Add parameters. Configure as seguintes opções:
1. Insira um nome personalizado para o novo parâmetro.
2. Clique no botão para pesquisar e associar um parâmetro de saída de um nó upstream.

Após terminar de configurar os parâmetros, feche o painel de schedule settings. Na página do nó de parâmetros, clique em Add e configure as seguintes opções:

Parâmetro	Descrição
Nome do parâmetro	Um nome de parâmetro personalizado. Nota Esse nome é usado para seleção quando os nós downstream adicionam parâmetros.
Tipo de parâmetro	Variável de passagem.
Valor	selecione um parâmetro upstream que foi associado nas configurações de agendamento na lista suspensa.
Descrição	Uma descrição personalizada do parâmetro.

Após configurar o parâmetro de variável de passagem, clique em Save na coluna Actions para salvar o parâmetro.

Após terminar de configurar os parâmetros do nó de parâmetros, configure suas opções de agendamento. Para obter mais informações, consulte configure schedule settings.

Etapa 2: Usar parâmetros em nós downstream

Após configurar o nó de parâmetros, use seus parâmetros diretamente nos nós downstream para um gerenciamento centralizado de parâmetros.

Nota

Para usar parâmetros de um nó de parâmetros em um nó downstream, adicione parâmetros nos parâmetros de agendamento do nó downstream para associá-los ao nó de parâmetros.

Associe os parâmetros do nó de parâmetros upstream.
1. Abra o editor do nó de parâmetros e clique em schedule settings no lado direito. Em Scheduling Settings > Scheduling Dependency > Node dependency configuration, clique em Add Dependency e configure o nó de parâmetros como uma dependência upstream.
2. Após configurar a dependência, alterne para Scheduling Parameters e clique em Add parameters. Configure as seguintes opções:
  1. Insira um nome personalizado para o novo parâmetro.
  2. Clique no botão para pesquisar e associar um parâmetro de saída do nó de parâmetros upstream.
Após configurar os parâmetros, referencie-os no script do nó usando ${parameter name} para obter os parâmetros transmitidos do nó de parâmetros.

Etapa 2: Implante e gerencie o nó

Após concluir as configurações de agendamento, envie e implante o nó junto com seus nós upstream e downstream no ambiente de produção. Para obter mais informações, consulte Deploy nodes.
Após a implantação, a tarefa executa periodicamente com base no agendamento configurado. Visualize as tarefas agendadas implantadas e execute operações de O&M em Operation and Maintenance Center > Node O&M > Auto Triggered Task O&M > Auto Triggered Task. Para obter mais informações, consulte gerencie scheduled tasks.