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

O nó de parâmetro é um nó virtual especial que permite gerenciar parâmetros em um workflow e transmiti-los entre nós de tarefa. Ele aceita parâmetros constantes, variáveis e a passagem direta de parâmetros de nós upstream. Nós que exigem parâmetros podem simplesmente estabelecer uma dependência com o nó de parâmetro. Este tópico descreve como criar um nó de parâmetro para garantir eficiência no desenvolvimento de dados no DataWorks.

Visão geral

O nó de parâmetro é um nó virtual que não executa tarefas de computação de dados nem produz dados. Sua função principal é permitir a transmissão de parâmetros entre nós e o gerenciamento centralizado desses valores.

Transmissão de parâmetros entre nós

Em um workflow, caso um nó downstream precise de parâmetros de saída de vários nós upstream em diferentes níveis, utilize um nó de parâmetro para consolidá-los. Adicione todos os parâmetros necessários ao nó de parâmetro e defina o nó downstream para depender diretamente dele, garantindo acesso a todos os valores necessários.

Na figura acima, o nó Sq_MySQL_G requer os parâmetros de saída dos nós Sq_MySQL_B e Sq_MySQL_E. Utilize um nó de parâmetro como downstream tanto para Sq_MySQL_B quanto para Sq_MySQL_E. Adicione ao nó de parâmetro todos os valores necessários para Sq_MySQL_G e configure Sq_MySQL_G como downstream do nó de parâmetro para receber seus parâmetros de saída. Assim, Sq_MySQL_G obtém os parâmetros de Sq_MySQL_B e Sq_MySQL_E por meio do nó de parâmetro.
Gerenciamento centralizado de parâmetros

Quando os nós de tarefa downstream em um workflow precisam utilizar determinados parâmetros constantes ou variáveis, adicione todos esses valores a um único nó de parâmetro. Os nós downstream que necessitam deles podem então depender diretamente do nó de parâmetro. Essa abordagem centraliza o gerenciamento de parâmetros do workflow.

Na figura acima, os nós Sq2_MySQL_A, Sq2_MySQL_C, Sq2_MySQL_D, Sq2_MySQL_E e Sq2_MySQL_F exigem parâmetros. Utilize um nó de parâmetro para obter parâmetros de saída dos nós upstream e configurar as variáveis ou constantes necessárias. Esse nó serve então como dependência upstream para os nós que requerem tais parâmetros.

Pré-requisitos

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

Para desenvolver tarefas com um usuário RAM, adicione-o ao workspace como membro e atribua a função Develop ou Workspace Administrator. A função Workspace Administrator concede mais permissões do que o necessário; tenha cautela ao atribuí-la. Para mais informações sobre como adicionar membros e atribuir funções, consulte Adicionar membros a um workspace.
Um grupo de recursos serverless deve estar associado ao seu workspace. Para mais detalhes, consulte os tópicos no diretório Usar grupos de recursos serverless.
Antes de configurar um nó de parâmetro, crie-o. Para mais informações, consulte Criar nós para um workflow de agendamento.

Observação

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

Etapa 1: Configurar o nó de parâmetro

Você pode criar parâmetros constantes, variáveis e variáveis de passagem direta em um nó de parâmetro. As seções a seguir descrevem como configurar esses três tipos de parâmetros.

Adicionar um parâmetro constante

Um parâmetro constante possui um valor fixo, configurável diretamente no nó de parâmetro.

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

Configure o parâmetro constante:

Parâmetro	Descrição
Nome do parâmetro	Nome personalizado para o parâmetro. Nota Os nós downstream utilizam este nome para seleção ao adicionar parâmetros.
Tipo de parâmetro	Constante.
Valor	Valor constante personalizado conforme suas necessidades de negócio.
Descrição	Descrição do parâmetro baseada nos requisitos do seu negócio.

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 tempo do sistema, defina o tipo de parâmetro como variável ao adicioná-lo.

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

Configure o parâmetro variável:

Parâmetro	Descrição
Nome do parâmetro	Nome personalizado para o parâmetro. Nota Os nós downstream utilizam este nome para seleção ao adicionar parâmetros.
Tipo de parâmetro	Variável.
Valor	Valor variável personalizado conforme suas necessidades de negócio. Nota Para mais informações sobre parâmetros variáveis, consulte Configurar parâmetros de agendamento.
Descrição	Descrição do parâmetro baseada nos requisitos do seu negócio.

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 direta

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

Abra o editor do nó de parâmetro 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 dependência upstream.
Após configurar a dependência, alterne para Scheduling Parameters e clique em Add parameters. Defina as seguintes configurações:
1. Insira um nome personalizado para o novo parâmetro.
2. Clique em no botão para pesquisar e associar um parâmetro de saída de um nó upstream.

Ao concluir a configuração dos parâmetros, feche o painel de schedule settings. Na página do nó de parâmetro, clique em Add e defina as seguintes configurações:

Parâmetro	Descrição
Nome do parâmetro	Nome personalizado para o parâmetro. Nota Os nós downstream utilizam este nome para seleção ao adicionar parâmetros.
Tipo de parâmetro	Variável de passagem direta.
Valor	Selecione na lista suspensa um parâmetro upstream associado nas configurações de agendamento.
Descrição	Descrição do parâmetro baseada nos requisitos do seu negócio.

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

Ao terminar de configurar os parâmetros do nó de parâmetro, defina suas configurações de agendamento. Para mais informações, consulte Configurar definições de agendamento.

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

Após configurar o nó de parâmetro, utilize seus parâmetros diretamente nos nós downstream para centralizar o gerenciamento e aumentar a eficiência do desenvolvimento.

Nota

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

Associe os parâmetros do nó de parâmetro upstream.
1. Abra o editor do nó de parâmetro 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âmetro como dependência upstream.
2. Após configurar a dependência, alterne para Scheduling Parameters e clique em Add parameters. Defina as seguintes configurações:
  1. Insira um nome personalizado para o novo parâmetro.
  2. Clique em no botão para pesquisar e associar um parâmetro de saída do nó de parâmetro upstream.
Após configurar os parâmetros, referencie-os no script do nó usando ${parameter name} para obter os parâmetros transmitidos pelo nó de parâmetro.

Etapa 3: Implantar e gerenciar 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 mais informações, consulte Implantar nós.
Após a implantação, a tarefa é executada periodicamente com base no agendamento configurado. Visualize as tarefas agendadas implantadas e realize operações de O&M em Operation and Maintenance Center > Node O&M > Auto Triggered Task O&M > Auto Triggered Task. Para mais detalhes, consulte Gerenciar tarefas agendadas.