Um nó de parâmetro é um nó virtual que gerencia parâmetros em fluxos de trabalho e os transmite entre nós. Ele aceita parâmetros constantes, variáveis e a passagem transparente de parâmetros de nós ancestrais.
Informações básicas
Nós de parâmetro são nós virtuais que não executam tarefas de computação. Eles transmitem parâmetros entre nós e gerenciam parâmetros em fluxos de trabalho.
-
Parameter passing between nodes
Se um nó em um fluxo de trabalho precisar dos parâmetros de saída de seus nós ancestrais, crie um nó de parâmetro como intermediário. Posicione-o como descendente desses nós ancestrais e ancestral do nó de destino e adicione todos os parâmetros necessários a ele.
Na figura anterior, o nó sql_7 precisa de parâmetros de saída dos nós sql_1, sql_3 e sql_4. Um nó de parâmetro foi posicionado entre eles para coletar e encaminhar todos os parâmetros necessários ao sql_7. -
Parameter management
Caso vários nós em um fluxo de trabalho compartilhem parâmetros constantes ou variáveis, crie um nó de parâmetro como ancestral comum e adicione todos os parâmetros compartilhados a ele. Essa prática centraliza o gerenciamento de parâmetros do fluxo de trabalho.
Na figura anterior, os nós sql_3, sql_4, sql_5 e sql_7 compartilham parâmetros por meio de um nó de parâmetro comum que atua como seu ancestral.
Precauções
Para utilizar parâmetros de um nó de parâmetro, o nó deve ser descendente direto desse nó de parâmetro.
Limites
Regiões compatíveis: China (Hangzhou), China (Shanghai), China (Beijing), China (Shenzhen), China (Chengdu), China (Hong Kong), Japan (Tokyo), Singapore, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Germany (Frankfurt), UK (London), US (Silicon Valley) e US (Virginia).
Criar um nó de parâmetro
-
Faça login no console do DataWorks. Na região de destino, clique em no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Data Development.
-
Na página DataStudio, passe o mouse sobre o ícone
e escolha .Alternativamente, abra um fluxo de trabalho, clique com o botão direito em General e escolha .
Na caixa de diálogo Create Node, insira um Name e selecione um Path.
Clique em OK.
Configurar propriedades de agendamento do nó de parâmetro
Após criar o nó de parâmetro, configure suas propriedades de agendamento conforme os requisitos do negócio.
As propriedades de agendamento incluem propriedades básicas, de tempo, de recursos e dependências de agendamento. Como o nó de parâmetro apenas gerencia e transmite parâmetros sem executar tarefas de desenvolvimento de dados, preste atenção especial às dependências de agendamento.
Para usar os parâmetros de um nó de parâmetro, o nó deve ser descendente desse nó de parâmetro.
Os nós ancestrais cujos parâmetros exigem transmissão transparente devem ser ancestrais do nó de parâmetro.
Para obter mais informações sobre como configurar propriedades de agendamento de um nó de parâmetro, consulte Configure basic properties, Configure time properties, Configure the resource property e Configure same-cycle scheduling dependencies.
Adicionar parâmetros ao nó de parâmetro
Depois de configurar as propriedades de agendamento, adicione ao nó de parâmetro os parâmetros que deseja gerenciar ou transmitir.
Na página de configuração do nó de parâmetro, clique em Add Parameter.
-
Configure o Parameter name, o Type, o Value e a Description e clique em Save.
Uma nota no topo da página lembra que qualquer nó que referencie esses parâmetros deve ser descendente direto deste nó de parâmetro. Os tipos de parâmetro incluem Constant, Variable e Pass-through Variable.
Constant: o parâmetro tem valor fixo.
Variable: o valor do parâmetro é dinâmico. Escolha este tipo se precisar usar variáveis de sistema, como a hora atual. Para obter mais informações sobre formatos compatíveis, consulte Supported formats for scheduling parameters.
Pass-through Variable: transmite um parâmetro de saída de um nó ancestral direto para um nó descendente. Para esse tipo, selecione o valor em uma lista com todos os parâmetros de saída disponíveis dos nós ancestrais diretos deste nó de parâmetro.
Próximos passos: usar os parâmetros no nó de parâmetro
Após configurar o nó de parâmetro, os nós descendentes podem usar diretamente os parâmetros, o que permite o gerenciamento centralizado e torna o desenvolvimento de tarefas mais eficiente.
Para utilizar esses parâmetros, configure-os como parâmetros de entrada dos nós descendentes. Assim, será possível referenciá-los diretamente no código do nó.
-
Configure os parâmetros como parâmetros de entrada dos nós descendentes.
No nó descendente, acesse a seção . Na subseção Input Parameters, clique em Add. Insira o nome do parâmetro, selecione a origem do valor e clique em Save. As configurações são as seguintes:
Parameter Name: nome do parâmetro necessário ao nó descendente. Visualize o nome do parâmetro no nó de parâmetro.
-
Value Source: origem do parâmetro necessário ao nó descendente.
Passe o mouse sobre as informações truncadas do parâmetro para ver os detalhes completos. Os parâmetros provenientes do nó de parâmetro aparecem no formato Output name of the parameter node:Parameter name. Selecione o nome da origem que termina com o nome do parâmetro desejado.
Use os parâmetros no código do nó descendente.