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.
Após a conclusão da execução de um nó de consulta SQL upstream, ele gera um parâmetro de saída chamado
outputscom os resultados da consulta.No nó de push de dados downstream, use Node Context Parameters para recuperar o parâmetro
outputsdo 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:
Nó de atribuição: Nós de consulta MaxCompute SQL não são compatíveis diretamente. Se necessário, crie um nó de atribuição para consultar dados do MaxCompute.
Outros nós SQL: Nó Hologres SQL, Nó ClickHouse SQL, Nó AnalyticDB for MySQL SQL, Nó AnalyticDB for PostgreSQL SQL, Nó StarRocks SQL, Nó PostgreSQL e Nó MySQL.
Pré-requisitos
Você já criou um workspace.
Você já criou um grupo de recursos serverless e o associou ao workspace do DataWorks de destino.
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
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 na coluna Actions.
No painel de navegação à esquerda, clique em
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.
Crie um fluxo de trabalho e adicione um nó de consulta SQL e um nó de push de dados a esse fluxo.
-
Crie um nó de consulta SQL e adicione o código SQL referente aos dados que deseja consultar e enviar.
NotaO 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.
-
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.
-
Você já criou um nó de push de dados e configurou o nó de consulta SQL como upstream.
Clique em Scheduling Settings. Na seção , 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.
Na seção , selecione o grupo de recursos serverless criado.
Na seção , 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.
-
Se o destino não existir, clique em Create Destination. Também é possível definir um destino de push de dados no Data Service.
NotaPara modificar um destino de push de dados, acesse a página Gerenciamento de destinos de Data Push no Data Service.
-
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.
-
Para obter informações sobre como adquirir um Webhook de bot do Lark, consulte Configuração de gatilho de Webhook do Lark.
-
Para obter informações sobre como adquirir um Webhook do Teams, consulte Criar Webhooks de Entrada com Fluxos de Trabalho para Microsoft Teams.
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
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
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.