Todos os produtos
Search
Central de documentação

DataWorks:Nó de push de dados

Última atualização: Jun 27, 2026

O nó de push de dados envia resultados de consultas de outros nós do fluxo de trabalho do Data Studio para destinos como DingTalk, Lark, WeCom, Teams ou e-mail mediante a criação de um destino de push. Assim, os membros da equipe recebem e se mantêm informados sobre os dados mais recentes em tempo hábil.

Contexto

Um nó de push de dados utiliza Node Context Parameters para recuperar parâmetros de saída de nós de consulta SQL upstream, como nós de atribuição, Hologres SQL ou ClickHouse SQL. Em seguida, edite esses parâmetros no corpo do push como placeholders e envie o conteúdo ao destino.

image
  • Após a conclusão da execução de um nó de consulta SQL upstream, ele gera um parâmetro de saída chamado outputs com os resultados da consulta.

  • No nó de push de dados downstream, use Node Context Parameters para recuperar o parâmetro outputs do nó upstream e vinculá-lo como parâmetro de entrada do nó de push de dados.

  • Na configuração do nó de push de dados, referencie o parâmetro de entrada como conteúdo do push, defina o destino e envie o conteúdo.

Nós de consulta SQL upstream compatíveis:

Pré-requisitos

Limitações

  • Os limites de tamanho de dados variam conforme o destino de push:

    Destino do push

    Limites do push

    DingTalk

    O tamanho dos dados de push não pode exceder 20 KB.

    Lark

    O tamanho dos dados de push não pode exceder 20 KB, e as imagens devem ser menores que 10 MB.

    WeCom

    Cada bot pode enviar no máximo 20 mensagens por minuto.

    Teams

    O tamanho dos dados de push não pode exceder 28 KB.

    E-mail

    Cada tarefa de push de dados aceita apenas um corpo de e-mail. Se já houver um corpo adicionado, não será possível incluir outro. Para mais restrições, consulte os limites SMTP do seu serviço de e-mail.

  • Regiões compatíveis com o Data Push:

    China (Hangzhou), China (Shanghai), China (Beijing), China (Shenzhen), China (Chengdu), China (Hong Kong), Singapura, Japão (Tóquio), EUA (Vale do Silício) e EUA (Virgínia).

Acessar o Data Studio

  1. Acesse a página Workspaces no console do DataWorks. Na barra de navegação superior, selecione a região desejada. Localize o workspace e escolha Shortcuts > Data Studio na coluna Actions.

  2. No painel de navegação à esquerda, clique em image para acessar a página do Data Studio.

Criar um pipeline de push

Crie e configure um pipeline composto por um nó de consulta SQL e um nó de push de dados.

  1. Crie um fluxo de trabalho e adicione um nó de consulta SQL e um nó de push de dados a esse fluxo.

  2. Crie um nó de consulta SQL e adicione o código SQL referente aos dados que deseja consultar e enviar.

    Nota
    • O nó de push de dados não permite recuperar dados de consulta diretamente do ODPS SQL. É possível criar um nó de atribuição e consultar os dados a serem enviados nesse nó de atribuição.

    • Outros nós de consulta SQL podem ser criados normalmente.

  3. Configure o nó de consulta SQL.

    Configure Compute Resource, Resource Group for Scheduling e Same-cycle Dependency no painel Scheduling Settings à direita do nó. Caso não exista nenhum nó upstream, selecione Add Root Node. A configuração do parâmetro de saída varia conforme descrito abaixo:

    Tipo de nó

    Observações de configuração

    Nó de atribuição

    Possui um parâmetro de saída padrão. Nenhuma configuração adicional é necessária.

    Outros nós de consulta SQL

    Não possuem parâmetros de saída padrão. Acesse Node Context Parameters no painel Scheduling Settings à direita do nó, localize Node output parameters e clique em Add Assignment Parameter para transmitir os resultados da consulta atual ao nó de push de dados downstream por meio de parâmetros.

  4. Você já criou um nó de push de dados e configurou o nó de consulta SQL como upstream.

    1. Clique em Scheduling Settings. Na seção Scheduling Dependency > Same-cycle Dependency, clique em Add e pesquise pelo nome do nó para adicionar o nó de consulta SQL criado como upstream do nó de push de dados.

    2. Na seção Scheduling Policy > Resource Group for Scheduling, selecione o grupo de recursos serverless criado.

    3. Na seção Node Context Parameters > Input Parameters, clique em Add parameters para adicionar o parâmetro de saída do nó de consulta SQL como fonte de valor e vinculá-lo como parâmetro de entrada do nó de push de dados.

Configurar destinos e conteúdo do push

Na página de edição do nó de push de dados, personalize o título e configure o destino e o conteúdo do corpo.

Configurar o destino do push

Na seção Destination, selecione um destino.

  1. Se o destino não existir, clique em Create Destination. Também é possível definir um destino de push de dados no Data Service.

    Nota

    Para modificar um destino de push de dados, acesse a página Gerenciamento de destinos de Data Push no Data Service.

  2. Na página Create Destination, crie um destino de push de dados configurando os seguintes parâmetros.

    Criar um destino de push para DingTalk, Lark, WeCom ou Teams

    Parâmetro

    Descrição

    Destination

    Selecione DingTalk, Flying Book, WeCom ou Teams.

    Destination Name

    Personalize o nome conforme as necessidades do negócio.

    Webhook

    Obtenha e configure a URL do Webhook conforme o destino de push selecionado.

    Criar um destino de push de e-mail

    Parâmetro

    Descrição

    Destination

    Selecione Mail.

    SMTP Host

    Endereço do servidor SMTP usado para enviar e-mails.

    SMTP Port

    Porta do servidor SMTP usada para conexão ao servidor de e-mail. Valor padrão: 465. Altere manualmente se necessário.

    Sender Address

    Endereço de e-mail do remetente.

    Sender Nickname

    Opcional. Nome de exibição personalizado para o remetente.

    SMTP Account

    Conta de e-mail usada para fazer login no servidor SMTP.

    SMTP Password

    Senha usada para autenticar a conta SMTP.

    Receiver Address

    Endereços de e-mail dos destinatários. Separe múltiplos endereços com vírgulas (,).

Configurar o corpo do push

Configure o conteúdo do corpo em três formatos: Markdown, tabela e corpo de e-mail.

  • No corpo Markdown de um push de dados, utilize diretamente o nome do parâmetro dos Input Parameters do nó de push de dados como placeholder no formato ${input_parameter_name} para recuperar o parâmetro de saída do nó upstream.

  • No corpo de tabela de um push de dados, use os nomes das colunas do nó de consulta SQL upstream como Parameters para recuperar os dados.

  • O Data Push do DataWorks permite adicionar um corpo de e-mail ao conteúdo do push. Ao editar o corpo do e-mail, observe o seguinte:

    • Cada tarefa de push de dados aceita apenas um corpo de e-mail.

    • O corpo do e-mail é renderizado somente quando o destino do push é e-mail. Caso contrário, o corpo do e-mail ficará oculto na mensagem enviada via Webhook.

Depurar o push de dados

Após concluir a configuração, salve o nó de consulta SQL e o nó de push de dados. Em seguida, clique em image na barra de ferramentas acima do fluxo de trabalho para depurar a tarefa de push de dados.

Próximas etapas

  • Configurar definições de agendamento: Para executar os nós no diretório do projeto periodicamente, configure a Scheduling Policy no painel Scheduling Settings à direita do nó.

  • Implantar um nó: Para implantar tarefas no ambiente de produção, clique em image na página para iniciar o processo. Os nós no diretório do projeto só serão agendados periodicamente após a implantação no ambiente de produção.