Todos os produtos
Search
Central de documentação

DataWorks:Gerenciar e usar extensões

Última atualização: Jun 27, 2026

Após desenvolver, implantar e registrar uma extensão, você deve testá-la, aprová-la e publicá-la. Depois da publicação, outros administradores além do proprietário podem ativá-la no Administration. Este tópico descreve como testar, publicar e usar uma extensão.

Contexto

Uma extensão registrada precisa passar por testes e revisão antes da publicação. Após a publicação, administradores de workspace ou de tenant podem ativá-la no Administration.

image

Pré-requisitos

Open Platform

Administradores da Open Platform e administradores de tenant podem seguir as etapas abaixo para testar, revisar e publicar uma extensão.

Etapa 1: Acessar a página Extensions

A página Extensions exibe todas as extensões registradas.

  1. Faça login no console do DataWorks. Na região desejada, clique em More > Open Platform no painel de navegação à esquerda. Clique em Go to Open Platform para abrir a página Developer Backend.

  2. Visualize os detalhes da extensão.

    Na página Developer Backend, clique em Extensions para acessar a página Extensions. Localize a extensão que deseja publicar e clique em Details na coluna Actions para visualizar sua configuração.

Etapa 2: Testar a extensão

Ao ser registrada, a extensão entra no estado Testing por padrão. Nesse estado, é possível testá-la em cenários específicos sem publicá-la.

  • Eventos de extensão no nível de tenant

    O proprietário da extensão pode ativá-la no Administration. No estado Testing, a extensão se aplica apenas às operações do próprio proprietário. Para mais informações, consulte Etapa 2: Ativar a extensão.

    Por exemplo, considere uma extensão em estado Testing projetada para validar solicitações de download de dados. Após o proprietário ativá-la no Administration, quando ele tentar baixar dados, a extensão interceptará a operação e a pausará até retornar um resultado de validação.

  • Eventos de extensão no nível de workspace

    Se um evento de ponto de extensão for do nível de workspace, a extensão terá efeito no workspace especificado durante o registro. Para identificar o workspace de teste definido, consulte Visualizar detalhes da extensão.

Antes de publicar a extensão, ative-a no workspace de teste conforme o tipo de evento tratado. Em seguida, teste todo o fluxo de trabalho, incluindo o envio de mensagens pelo DataWorks, o recebimento pela extensão e a execução da revisão e callback das mensagens.

Etapa 3: Publicar a extensão

Depois que a extensão passar nos testes, siga a Etapa 1 para acessar a página de detalhes da extensão na Open Platform e clique em Submit na coluna Actions para enviá-la para revisão pela plataforma DataWorks. Após a aprovação da revisão, clique em Publish na coluna Actions para publicar a extensão.

Nota

Após o envio para revisão, a plataforma DataWorks concluirá a análise dentro de T+3 dias úteis. Se a revisão falhar, passe o mouse sobre o ícone de aviso de falha para visualizar o motivo. Modifique a extensão com base no feedback recebido e reenvie-a para revisão.

Etapa 4: Gerenciar o status da extensão

Na Open Platform, acesse Developer Backend > Extensions. Na coluna Actions da lista de extensões, visualize Details, Modify, Submit, Publish, Disable e Delete uma extensão. A coluna Status exibe o status atual da extensão:

  • Testing: Uma extensão recém-registrada fica no estado Testing por padrão. Uma extensão publicada que é retirada do ar também muda para o estado Testing. Extensões nesse estado só podem ser usadas no workspace de teste.

  • Pending Approval: Ao clicar em Submit para uma extensão no estado Testing, seu status muda para Pending Approval. Se a revisão for aprovada, o status muda para Approved, permitindo a publicação da extensão. Caso a revisão falhe, o status muda para Review Failed.

  • Published: Ao clicar em Publish na coluna Actions, o status da extensão muda para Published. Após a publicação, todos os workspaces aplicáveis podem usar a extensão. Administradores de workspace podem visualizá-la e ativá-la na página de configuração do workspace.

  • Disabled: Ao clicar em Disable na coluna Actions, o status da extensão muda para Disabled. Nesse estado, a extensão fica inativa e os fluxos de trabalho de eventos acionados em workspaces onde ela estava ativada passarão diretamente, sem verificações ou bloqueios.

  • Expired: Quando a assinatura do DataWorks Enterprise Edition expira, o status da extensão muda para Expired. Uma extensão nesse estado fica inativa, semelhante ao estado Disabled.

Administration

Administradores de workspace podem ativar eventos de ponto de extensão no nível de workspace na página Extensions no Administration. Administradores de tenant podem ativar eventos de ponto de extensão no nível de tenant na página Extensions no Administration.

Etapa 1: Acessar a página Extensions no Administration

  1. Faça login no console do DataWorks. Na região desejada, clique em More > Management Center no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Management Center.

  2. Visualize as extensões disponíveis para ativação.

    No Administration, clique em Extensions no painel de navegação à esquerda para acessar a página Extensions. Essa página exibe as extensões disponíveis para ativação.

Etapa 2: Ativar a extensão

Extensões de diferentes níveis aplicam-se a escopos distintos após a ativação:

  • Extensões no nível de tenant só podem ser ativadas por contas Alibaba Cloud, usuários RAM com a permissão AliyunDataWorksFullAccess ou administradores de tenant. Após a ativação de uma extensão desse nível, todas as operações no ponto de extensão correspondente em todos os workspaces serão bloqueadas até que a extensão retorne um resultado de validação.

  • Extensões no nível de workspace só podem ser ativadas por administradores de workspace. Para ativar esse tipo de extensão, especifique os workspaces onde ela terá efeito. Após a ativação, todas as operações no ponto de extensão correspondente nos workspaces especificados serão bloqueadas até que a extensão retorne um resultado de validação.

Nota
  • Caso não encontre a extensão necessária, acesse a página Open Platform > Extensions e verifique se ela já foi publicada.

  • Se você definiu configurações opcionais para a extensão, clique no botão de configurações na coluna Actions da página Administration > Extensions para configurá-la.

Lado do módulo

Quando um administrador de workspace ou administrador de tenant ativa a validação de checkpoint de extensão para um workspace ou tenant pelas etapas anteriores, as operações de desenvolvedores ou operadores no ponto de extensão dentro desse workspace ou tenant são bloqueadas até que a extensão retorne um resultado de validação. Para exemplos específicos de cenários de interceptação, consulte a documentação a seguir.