O nó de parâmetro é um tipo especial de nó virtual usado para gerenciar parâmetros em fluxos de trabalho e transmiti-los entre nós. Ele permite administrar parâmetros constantes e variáveis, além de repassar transparentemente os parâmetros dos nós ancestrais. Os nós que precisam utilizar parâmetros podem obtê-los diretamente dos nós de parâmetro. Este tópico descreve como criar um nó de parâmetro.
Informações básicas
Os nós de parâmetro são nós virtuais que não executam tarefas de computação. Eles servem para transmitir parâmetros entre nós e gerenciá-los nos fluxos de trabalho.
-
Parameter passing between nodes
Se o Nó A em um fluxo de trabalho precisar obter os parâmetros de saída de seus nós ancestrais, crie um nó de parâmetro. Utilize-o como ancestral do Nó A e descendente dos ancestrais do Nó A. Em seguida, adicione todos os parâmetros necessários ao Nó A nesse nó de parâmetro. Assim, o Nó A poderá obter todos os parâmetros necessários a partir do nó de parâmetro.
Na figura anterior, o nó sql_7 precisa obter os parâmetros de saída dos nós sql_1, sql_3 e sql_4. Um nó de parâmetro atua como descendente dos nós sql_1, sql_3 e sql_4 e como ancestral do nó sql_7. Todos os parâmetros exigidos pelo nó sql_7 foram adicionados ao nó de parâmetro, permitindo que o nó sql_7 obtenha todos os dados necessários a partir dele. -
Parameter management
Quando vários nós de um fluxo de trabalho precisam usar os mesmos parâmetros constantes ou variáveis, crie um nó de parâmetro e defina-o como ancestral desses nós. Adicione todos os parâmetros compartilhados ao nó de parâmetro. Dessa forma, os nós dependentes poderão recuperar todas as informações necessárias a partir dessa source centralizada. O nó de parâmetro facilita o gerenciamento centralizado de todos os parâmetros utilizados no fluxo de trabalho.
No exemplo acima, os nós sql_3, sql_4, sql_5 e sql_7 necessitam de determinados parâmetros. Um nó de parâmetro foi criado como ancestral desses quatro nós. Ao adicionar todos os parâmetros requisitados ao nó de parâmetro, os nós sql_3, sql_4, sql_5 e sql_7 conseguem obter tudo o que precisam a partir dele.
Precauções
Para utilizar os parâmetros definidos em um nó de parâmetro, o nó deve ser obrigatoriamente um descendente direto desse nó de parâmetro.
Limites
Regiões suportadas: China (Hangzhou), China (Xangai), China (Pequim), China (Shenzhen), China (Chengdu), China (Hong Kong), Japão (Tóquio), Singapura, Malásia (Kuala Lumpur), Indonésia (Jacarta), Alemanha (Frankfurt), Reino Unido (Londres), EUA (Vale do Silício) e EUA (Virgínia).
Criar um nó de parâmetro
-
Faça login no console do DataWorks. Na região desejada, 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 selecione .
Na caixa de diálogo Create Node, insira um Name e selecione um Path.
Clique em OK.
Configurar propriedades de agendamento para o nó de parâmetro
Após criar o nó de parâmetro, configure suas propriedades de agendamento conforme as necessidades do seu 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 não executa tarefas de desenvolvimento de dados — servindo apenas para gerenciar e repassar parâmetros —, preste atenção especial às dependências de agendamento configuradas para ele.
Qualquer nó que precise consumir parâmetros de um nó de parâmetro deve ser configurado como seu descendente.
Os nós ancestrais cujos parâmetros devem ser repassados transparentemente precisam constar como ancestrais do nó de parâmetro.
Para mais detalhes sobre como configurar as propriedades de agendamento de um nó de parâmetro, consulte Configurar propriedades básicas, Configurar propriedades de tempo, Configurar a propriedade de recurso e Configurar dependências de agendamento do mesmo ciclo.
Adicionar parâmetros ao nó de parâmetro
Depois de definir as propriedades de agendamento, adicione os parâmetros que deseja gerenciar e repassar ao nó de parâmetro para uso posterior. Esta seção detalha o procedimento.
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. Em seguida, clique em Save.
Uma nota no topo da página lembra que qualquer nó que referencie esses parâmetros deve ser um descendente direto deste nó de parâmetro. Os tipos de parâmetro incluem Constant, Variable e Pass-through Variable.
Constant: O parâmetro possui um valor fixo.
Variable: O valor do parâmetro é dinâmico. Escolha este tipo quando precisar usar variáveis de sistema, como a hora atual. Para mais informações sobre os formatos suportados, consulte Formatos suportados para parâmetros de agendamento.
Pass-through Variable: Repassa um parâmetro de saída de um nó ancestral direto para um nó descendente. Para este tipo, selecione o valor em uma lista contendo 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 do nó de parâmetro
Após configurar o nó de parâmetro, seus nós descendentes poderão usar diretamente os parâmetros ali definidos. Isso facilita o gerenciamento centralizado e aumenta a eficiência no desenvolvimento de tarefas dos nós descendentes.
Antes que os nós descendentes possam consumir esses dados, configure os parâmetros como entradas nesses nós. Assim, eles ficarão disponíveis para uso direto no código dos nós descendentes.
-
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 que o nó descendente precisa utilizar. É possível visualizar esse nome no próprio nó de parâmetro.
-
Value Source: origem do parâmetro que o nó descendente irá consumir.
Se as informações do parâmetro não estiverem totalmente visíveis, passe o ponteiro do mouse sobre elas para ver o conteúdo completo. Todos os parâmetros adicionados ao 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.
Utilize os parâmetros no código do nó descendente.