Todos os produtos
Search
Central de documentação

DataWorks:Exemplo: Verificação de eventos durante o desenvolvimento de dados

Última atualização: Jun 27, 2026

Após registrar, publicar e ativar uma extensão na DataWorks Open Platform, o DataWorks envia uma mensagem de evento à extensão sempre que um evento de ponto de extensão ocorre no workspace relevante. Com base na resposta da extensão, o DataWorks determina se permite a operação. Este tópico descreve os eventos de ponto de extensão compatíveis com o Data Studio e explica como usá-los para acionar uma extensão.

Pré-requisitos

Informações básicas

  • Ative a extensão.

    Na página Management Center, visualize as Extensions e ative ou desative a verificação de extensão do workspace atual.

  • Eventos de ponto de extensão no Desenvolvimento de Dados.

    O módulo Data Studio do DataWorks é compatível com eventos de ponto de extensão como pré-publicação de arquivo, pré-commit de arquivo e pré-envio de tabela. Para obter uma lista detalhada dos eventos de ponto de extensão e conceitos relacionados, consulte Lista de eventos de ponto de extensão compatíveis.

  • O DataWorks envia notificações de mensagem para eventos de ponto de extensão. Assim, as extensões validam e respondem automaticamente a esses eventos. Para mais detalhes sobre o processo de acionamento, consulte Eventos de ponto de extensão compatíveis.

Limites

Com a extensão ativada, aplicam-se os seguintes limites às notificações de mensagem e respostas para eventos acionados durante o desenvolvimento de dados.

  • A extensão integrada ativada é compatível apenas com nós ODPS SQL.

    Isso significa que, ao acionar um evento de ponto de extensão para um nó ODPS SQL, o sistema bloqueia o processo. A extensão integrada valida a lógica e retorna um resultado. Se o evento for acionado para um nó não ODPS SQL, o sistema também bloqueia o processo, mas a extensão integrada não executa validação e retorna imediatamente um resultado de sucesso.

  • Os eventos pre-publish table event e pre-submit table event são pontos de extensão acionados exclusivamente para tabelas do MaxCompute.

  • Em nós compostos com nós internos, como nós do-while e nós for-each, todos os nós internos devem passar na verificação antes que a próxima operação prossiga.

Visão geral dos recursos

Registre um serviço ou programa local como extensão do DataWorks para receber mensagens de eventos específicos de ponto de extensão no módulo Data Studio. Essa abordagem permite implementar lógica personalizada para tratar esses eventos e retornar os resultados à plataforma por meio de callback para a API UpdateIDEEventResult. Esse método viabiliza o controle de processos no DataWorks. Os pontos de extensão compatíveis são:

  • Operações de arquivo: execute, fazer commit, publicar e exclua arquivos.

  • Operações de tabela: envie e publicar tabelas.

    Nota

    Os eventos de extensão para operações de tabela no Data Studio só podem ser acionados para tabelas do MaxCompute.

Eventos de ponto de extensão compatíveis

No Data Studio, use extensões para validar e responder aos seguintes eventos de ponto de extensão.

DataStudio - Execute File No editor de código do DataStudio, clique em Run para acionar um evento de pré-verificação da extensão. Uma sobreposição Checking aparece com a mensagem: "The operation will be automatically executed after the check is passed. You can view the results in [Operation Check]." No painel Operation Check à esquerda, visualize todos os registros de verificação (incluindo tipos como execução, commit de arquivo e exclusão). Clique em um registro para abrir a caixa de diálogo de detalhes e visualizar o tipo de verificação, o status e os detalhes de cada extensão.

DataStudio - Submit File: Ao enviar um arquivo no DataStudio, o sistema aciona uma verificação de evento de pré-commit de arquivo. Clique em Submit na barra de ferramentas para iniciar a verificação da extensão. O editor exibe o aviso "Checking" e executa a operação automaticamente após a aprovação na verificação. Acompanhe o status de cada item de verificação no painel Operation Check à esquerda. A lista exibe "Trigger file pre-commit event check".

DataStudio - Publishing a file Após clicar em Publish no editor de código para enviar um arquivo, o sistema aciona uma verificação de extensão. A interface Create Deployment Package é exibida com o status do nó correspondente na lista de arquivos definido como Checking and validating. Clique em o status do nó para abrir a caixa de diálogo Operation Check e visualizar o tipo de verificação, o status e os detalhes da validação.

DataStudio - Delete file Na árvore de arquivos do Data Studio, clique com o botão direito no nó desejado e selecione Delete. Essa ação aciona um evento de pré-verificação do programa de extensão. Uma notificação azul aparece na parte inferior da página informando: "This operation has triggered a check. The operation takes effect automatically after the check passes. Please view the check result in 'Operation Check'." Acesse a página Operation Check para visualizar a lista de registros de verificação. A lista inclui as colunas Name/Operation Time, Type e Status. Clique em um registro específico para ver os detalhes da verificação da operação. Os detalhes incluem o tipo de verificação, como "Pre-delete combination test", e o status atual, como "Checking". A página também fornece os links View Details e View Document.

DataStudio: Submit table Ao enviar uma tabela (como xc_table_prod) para um ambiente de desenvolvimento ou produção, o sistema aciona automaticamente uma pré-verificação pelo programa de extensão. Uma caixa de diálogo Checking aparece com a mensagem: "The operation runs automatically after the check passes. Please view the results in Operation Check." Na barra lateral Operation Check à esquerda, filtre e visualize todos os registros de verificação por tipo e status. Clique em um registro específico para abrir a caixa de diálogo de detalhes da Verificação de Operação. Esta caixa exibe a lista de validações de programas de extensão acionadas pela operação atual (como o tipo de verificação "Pre-submission check for table - Test program") e seus respectivos status de validação. As operações View Details e Re-check estão disponíveis.

DataStudio - Publish Table Na página de configuração da tabela, clique em a aba Submit to Production Environment para acionar uma verificação de extensão. O sistema exibe o aviso: "Checking - The operation will be automatically executed after the check passes. Please view the results in 'Operation Check'." Acesse a página Operation Check para visualizar a lista de registros de verificação. A lista contém o nome da tabela, horário de envio, tipo de verificação e status. Clique em um registro para ver os detalhes, que incluem o tipo de verificação (como Pre-publish Check for Table) e o status atual. Também é possível clicar em View Details e View Documentation. Esta operação aciona a validação das extensões ativadas para o tipo de evento de pré-publicação de tabelas no workspace.

Referências