Todos os produtos
Search
Central de documentação

DataWorks:Gerenciar e usar extensões

Última atualização: Sep 25, 2026

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

Contexto

Depois que uma extensão é registrada, ela precisa ser testada e revisada antes da publicação. Após a publicação, administradores de workspace ou administradores de tenant podem ativá-la em Administration.

image

Pré-requisitos

Open Platform

Administradores do 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

Na página Extensions, você visualiza todas as extensões registradas.

  1. Faça logon no DataWorks console. 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 ver a configuração dela.

Etapa 2: Testar a extensão

Depois do registro, a extensão entra por padrão no estado Testing. Nesse estado, você pode testá-la em cenários específicos sem publicá-la.

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

    O proprietário da extensão pode ativá-la em Administration. No estado Testing, a extensão se aplica somente às operações executadas pelo proprietário. Para mais informações, consulte Step 2: Enable the extension.

    Por exemplo, considere uma extensão no estado Testing projetada para validar solicitações de download de dados. Depois que o proprietário a ativa em Administration, ao tentar baixar dados, a extensão intercepta a operação e a pausa até que um resultado de validação seja retornado.

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

    Se um evento de ponto de extensão for de nível de workspace, a extensão passa a valer no workspace especificado durante o registro. Para localizar o workspace de teste especificado, consulte View extension details.

Antes de publicar a extensão, enable the extension no workspace de teste conforme o tipo de evento tratado por ela e teste o fluxo de trabalho completo, incluindo o envio de mensagens pelo DataWorks, o recebimento das mensagens pela extensão e a execução da revisão e do 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 no Open Platform e clique em Submit na coluna Actions para submetê-la à revisão da plataforma DataWorks. Após a aprovação da revisão, clique em Publish na coluna Actions para publicar a extensão.

Nota

Depois que você submete a extensão para revisão, a plataforma DataWorks conclui a análise em até T+3 dias úteis. Se a revisão falhar, passe o cursor sobre o ícone de aviso de falha para ver o motivo. Ajuste a extensão com base no feedback e submeta novamente para revisão.

Etapa 4: Gerenciar o status da extensão

No Open Platform, acesse Developer Backend > Extensions. Na coluna Actions da lista de extensões, você pode ver 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 assume por padrão o estado Testing. Uma extensão publicada que foi retirada do ar também passa para o estado Testing. Uma extensão no estado Testing só pode ser usada no workspace de teste.

  • Pending Approval: quando você clica em Submit para uma extensão no estado Testing, o status muda para Pending Approval. Se a revisão for aprovada, o status muda para Approved e a extensão pode ser publicada. Se a revisão falhar, o status muda para Review Failed.

  • Published: quando você clica 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: quando você clica em Disable na coluna Actions, o status da extensão muda para Disabled. Nesse estado, a extensão fica inativa, e os fluxos de eventos acionados em workspaces que a tinham ativada passam adiante diretamente, sem verificações nem bloqueios.

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

Administration

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

Etapa 1: Acessar a página Extensions em Administration

  1. Faça logon no DataWorks console. 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 que podem ser ativadas.

    Em Administration, clique em Extensions no painel de navegação à esquerda para acessar a página Extensions. Essa página exibe as extensões que podem ser ativadas.

Etapa 2: Ativar a extensão

Extensões de níveis diferentes aplicam-se a escopos diferentes depois de ativadas:

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

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

Nota
  • Se você não encontrar a extensão desejada, acesse a página Open Platform > Extensions e verifique se ela já foi publicada.

  • Se você configurou option settings 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 um administrador de tenant ativa a validação de checkpoint da extensão em um workspace ou tenant pelas etapas anteriores, as operações executadas por desenvolvedores ou operadores no ponto de extensão dentro do workspace ou tenant ficam 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.