Todos os produtos
Search

Este produto

    DataWorks:Usar parâmetros de workflow

    Central de documentação

    DataWorks:Usar parâmetros de workflow

    Última atualização: Jun 27, 2026

    Os parâmetros de workflow permitem atribuir ou substituir centralmente o valor de um parâmetro em vários nós de um workflow. Este tópico demonstra como usar um parâmetro de workflow para substituir o valor do parâmetro ReplaceMe nos nós de um workflow com gatilho automático.

    Pré-requisitos

    • Crie um workflow para configurar os parâmetros de workflow. Para mais informações, consulte Criar um workflow com gatilho automático e Criar um workflow com gatilho manual.

    • Crie nós no workflow. Os parâmetros de workflow configurados substituirão os valores originais dos parâmetros nesses nós.

      Nota

      Atualmente, os parâmetros de workflow são compatíveis apenas com os seguintes tipos de nó: ODPS SQL, PyODPS 3, EMR Spark Shell, EMR Spark, EMR Shell, EMR Hive, EMR MR, EMR Presto, EMR Trino, EMR Spark SQL, EMR Spark Streaming, EMR Streaming SQL e Hologres SQL. A interface exibe a lista mais atualizada de tipos de nó compatíveis.

      Para criar um nó, consulte Tipos de nó compatíveis.

    Tipos de nó compatíveis

    Atualmente, os parâmetros de workflow são compatíveis apenas com os seguintes tipos de nó: ODPS SQL, PyODPS 3, EMR Spark Shell, EMR Spark, EMR Shell, EMR Hive, EMR MR, EMR Presto, EMR Trino, EMR Spark SQL, EMR Spark Streaming, EMR Streaming SQL e Hologres SQL. A interface exibe a lista mais recente de tipos de nó compatíveis.

    Observações de uso

    • Após salvar um parâmetro de workflow, o DataWorks carrega a configuração mais recente sempre que você abre um nó compatível e o coloca em estado editável. Para que a nova configuração afete as execuções agendadas, submeta e implante o nó.

    • Se um parâmetro de workflow e um parâmetro de nível de nó tiverem o mesmo nome, o valor do parâmetro de workflow prevalecerá sobre o do nó.

    • Ao atribuir um valor a um parâmetro de workflow, o campo Value/Expression não aceita o formato ${key}:value. Por exemplo, var:1 e ${var}:1 são inválidos.

    Configurações de parâmetros de workflow

    1. Acesse a página DataStudio.

      Faça login no console do DataWorks. Na região desejada, clique em Data Development and O&M > Data Development no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Data Development.

    2. Abra as configurações de parâmetros de workflow.

      No DataStudio, localize o workflow na árvore do painel Data Development e dê um duplo clique nele para abrir o editor de workflow e acessar as configurações de Workflow Parameters. O lado esquerdo da aba exibe uma lista de nós comuns, como ODPS SQL, PyODPS 3, EMR Hive, EMR Spark SQL e Hologres SQL. A barra de ferramentas superior oferece os botões Run e Commit. No canto superior direito, estão disponíveis os links para Deploy e Operation Center.

    Configurar parâmetros de workflow

    O método de configuração de parâmetros é idêntico para todos os tipos de nó compatíveis. Recomendamos esse recurso quando você precisa atribuir o mesmo valor a um parâmetro em múltiplos nós de um workflow. Este tópico usa um exemplo para demonstrar como alterar o valor do parâmetro ReplaceMe em um nó ODPS SQL de 20230613 para 20230615 usando um parâmetro de workflow.

    1. Configure o parâmetro de nível de nó.

      1. Abra o editor do nó.

        Dê um duplo clique no nó ODPS SQL no workflow desejado para abrir o editor.

      2. Configure o parâmetro do nó.

        Defina o valor do parâmetro do nó ODPS SQL como 20230613. No editor de código, escreva a instrução SELECT ${ReplaceMe};. Clique na aba Properties no painel à direita. Na tabela Parameters, adicione um parâmetro com o nome ReplaceMe e o valor 20230613. Clique em Scheduling Parameter Preview. Na caixa de diálogo exibida, confirme se o parâmetro de cada instância está definido corretamente como ReplaceMe=20230613. Para mais detalhes sobre como configurar parâmetros de nó, consulte Configurar parâmetros de agendamento.

    2. Use um parâmetro de workflow para substituir o valor do parâmetro de nível de nó.

      1. Dê um duplo clique no workflow desejado e, no painel de navegação à direita do canvas do workflow, clique em Workflow Parameters.

      2. Na caixa de diálogo Workflow Parameters, configure o parâmetro.

        Este exemplo define o valor do parâmetro de workflow como 20230615. Após salvar a configuração, o valor do parâmetro no nó ODPS SQL será substituído por 20230615. Adicione vários parâmetros conforme necessário.

        Nota

        • Se um parâmetro de workflow e um parâmetro de nível de nó tiverem o mesmo nome, o valor do parâmetro de workflow substituirá o do nó.

        • Ao atribuir um valor a um parâmetro de workflow, o campo Value/Expression não aceita o formato ${key}:value. Por exemplo, var:1 e ${var}:1 são inválidos.

        Na caixa de diálogo Workflow Parameters, defina o Parameter Name como ReplaceMe e seu valor como 20230615 e clique em Save. Neste exemplo, cujo código ODPS SQL é SELECT ${ReplaceMe};, o valor analisado originalmente para o parâmetro ReplaceMe é 20230613. Ao clicar em Scheduling Parameter Preview, você verá que o parâmetro ReplaceMe para as próximas três instâncias assume o valor do parâmetro de workflow 20230615, o que confirma que o parâmetro de workflow entrou em vigor.

    Verificar a configuração

    Após configurar o parâmetro de workflow, execute o workflow para confirmar se o valor substitui corretamente o valor de nível de nó.

    1. Execute o workflow e atribua um valor à variável.

      Ao executar um workflow que utiliza parâmetros de workflow, atribua manualmente um valor a cada parâmetro durante a execução. Para mais informações, consulte o procedimento de depuração.

      1. Na barra de ferramentas do editor de workflow, clique no ícone Run 运行.

      2. Na caixa de diálogo Enter parameters., atribua o valor 20230615 à variável ReplaceMe.

    2. Verifique o resultado da execução.

      No canvas do workflow, clique com o botão direito no nó ODPS SQL e selecione View Log. O log aparece na parte inferior da página e mostra a atribuição do parâmetro. O valor do parâmetro do nó foi alterado de 20230613 para 20230615, o que confirma que o parâmetro de workflow teve efeito e a execução foi bem-sucedida. No log de execução, a linha SKYNET_PARAVALUE=ReplaceMe=20230615 indica que o parâmetro de workflow foi aplicado com sucesso.

      2023-06-14 16:19:57 INFO Current task status:RUNNING
2023-06-14 16:19:57 INFO Start execute shell on node cn-shanghai.475270149050624.1626085771455.
2023-06-14 16:19:57 INFO Current working dir /home/admin/alisatasknode/taskinfo/20230614/phoenix/16/19/55/mm8wog2kwtj8czebilx1dbcp
2023-06-14 16:19:57 INFO Full Command ..
2023-06-14 16:19:57 INFO ——————————
2023-06-14 16:19:57 INFO /opt/taobao/tbdpapp/odpswrapper/odpswrapper.py /home/admin/alisatasknode/taskinfo//20230614/phoenix/16/19/55/mm8wog2kwtj8czebilx1dbcp//275011_10728491_503348330 ReplaceMe=20230615
2023-06-14 16:19:57 INFO ——————————
2023-06-14 16:19:57 INFO List of passing environment ..
2023-06-14 16:19:57 INFO ——————————
2023-06-14 16:19:57 INFO SKYNET_BUSINESS_NAME=WorkFlow Parameters:
2023-06-14 16:19:57 INFO SKYNET_ENDPOINT=http://service.cn.maxcompute.aliyun-inc.com/api:
2023-06-14 16:19:57 INFO SKYNET_PTYPE=10:
2023-06-14 16:19:57 INFO SKYNET_ACTIONID=1:
2023-06-14 16:19:57 INFO TASK_WHITE_LIST=oapi.dingtalk.com:443,47.102.239.120:3306:
2023-06-14 16:19:57 INFO SKYNET_RERUN_MODE=1:
2023-06-14 16:19:57 INFO SKYNET_FLOW_PARAVALUE={"ReplaceMe":"20230615"}:
2023-06-14 16:19:57 INFO SKYNET_ONDUTY=204288958124218159:
2023-06-14 16:19:57 INFO SKYNET_SYSTEMID=dev:
2023-06-14 16:19:57 INFO CALC_ENGINE_IDENTIFIER=saochen_mc_0508_dev:
2023-06-14 16:19:57 INFO SKYNET_SOURCEID=700028402970:
2023-06-14 16:19:57 INFO SKYNET_PARAVALUE=ReplaceMe=20230615:
2023-06-14 16:19:57 INFO SKYNET_TASKID=708xxx:
2023-06-14 16:19:57 INFO SKYNET_TENANT_ID=283789484710656:

    Submeter e implantar o workflow

    Depois de verificar que a configuração do parâmetro de workflow está correta, submeta e implante o workflow para aplicar as alterações às execuções agendadas.

    1. Submeta o workflow.

      Ao submeter, selecione os nós que deseja incluir e forneça uma descrição das alterações.

      Nota

      Se este recurso estiver ativado, um revisor deverá aprovar o código submetido antes da implantação. Para mais informações sobre esse recurso, consulte revisão de código.

      Clique no botão Commit na barra de ferramentas. Na caixa de diálogo exibida, selecione os nós a serem submetidos, insira uma Change Description e configure Code Review e Force Modify conforme necessário. Marque também a caixa de seleção Ignore alerts for inconsistent I/O, se aplicável. Clique em OK.

    2. Implante o workflow.

      Se o workspace estiver no standard mode, clique no botão Deploy no canto superior direito após uma submissão bem-sucedida. Para mais informações, consulte Implantar nós.