Todos os produtos
Search
Central de documentação

DataWorks:Diretório do workspace

Última atualização: Sep 24, 2026

O diretório do workspace é uma estrutura organizacional voltada à colaboração em equipe. Ele permite gerencie código de nós e recursos no workspace, coordenando o desenvolvimento de tarefas agendadas.

Comparação entre tipos de diretório

O Data Studio disponibiliza diretórios de workspace e diretórios pessoais para diferentes necessidades de desenvolvimento. A tabela a seguir compara os dois tipos.

Tipo de diretório

Escopo de permissão

Recursos

Casos de uso

diretório do workspace

Nível de workspace

  • Suporta desenvolvimento colaborativo em equipe.

  • Permite crie tarefas agendadas (workflows ou nós).

  • Os nós deste diretório pertencem ao workspace.

Criação de tarefas de produção executadas em agendamento.

diretório pessoal

Nível de conta

  • Suporta depuração individual de código.

  • Não permite crie tarefas agendadas.

  • Os arquivos deste diretório são visíveis apenas para você.

Desenvolvimento e depuração individual de código.

Acesse o diretório do workspace

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

  2. No painel de navegação à esquerda do Data Studio, clique em no ícone image e escolha DataStudio > Project Directory.

Gerencie diretórios

Crie uma estrutura de diretórios

Crie uma estrutura de diretórios com base nos padrões do workspace.

  1. No painel Project Directory, clique em Create Directory....

  2. Na caixa de diálogo Create Directory, configure as informações básicas do diretório.

    Parâmetro

    Descrição

    Path

    Especifique o caminho de armazenamento do diretório.

    Name

    Insira um nome para o diretório.

Gerencie tags de diretório

Os diretórios do workspace suportam tags para categorização. Com as tags, é possível distinguir entre tipos de diretório e filtrar rapidamente por categorias específicas. Por exemplo, você pode marcar um diretório como Workflow e, em seguida, filtrar todos os diretórios com essa tag.

  1. Marcar um diretório com tag

    In the workspace directory, localize o diretório que deseja marcar. Clique com o botão direito no nome do diretório e selecione Mark As>Workflow. O diretório agora está marcado como Workflow. Da mesma forma, você pode marcar diretórios como Data Integration, MaxCompute, Hologres, Flink, Algorithm, General ou Custom. Esse recurso garante compatibilidade com a estrutura de diretórios da versão anterior do Data Development, permitindo replicar rapidamente a estrutura antiga.

  2. Remover tag de um diretório

    In the workspace directory, localize um diretório com tag. Clique com o botão direito no nome do diretório e selecione Untag para remover a tag.

  3. Filtrar diretórios por tag

    Para filtrar diretórios por uma tag específica, clique em no ícone ... > Filter Tags no canto superior direito do painel Project Directory. Selecione os tipos de tag desejados e clique em OK.

Usar o modo de foco

O modo de foco fixa um diretório específico e oculta todos os demais, reduzindo a poluição visual para que você se concentre apenas no conteúdo relevante.

  1. Entrar no modo de foco.

    In the workspace directory, localize o diretório no qual deseja focar. Clique com o botão direito no nome do diretório e selecione Enter Focus Mode. Apenas o diretório selecionado será exibido.

  2. Sair do modo de foco.

    In the workspace directory, clique em no ícone image para sair do modo de foco, ou clique com o botão direito no diretório em foco e selecione Exit Focus Mode.

Crie e localizar workflows e nós

Crie um workflow ou nó

Dentro da estrutura de diretórios estabelecida, os membros do workspace podem crie nodes ou workflows agendados.

  1. Crie um workflow ou nó.

    No painel Workspace Directories, clique em no ícone image > Create Node... ou image > Create Workflow... e, em seguida, selecione o tipo de nó ou workflow que deseja crie.

  2. Desenvolver o workflow ou nó.

    A configuração depende do tipo de tarefa. Para mais informações, consulte Nodes ou Workflows.

Localizar workflows e nós

O diretório do workspace oferece diversos recursos para encontrar e localizar nós rapidamente.

1. Filtrar por proprietário

Clique em no ícone ... > Show... no canto superior direito do painel Project Directory e selecione Show all ou Show Managed by Me para filtrar os workflows ou nós exibidos.

2. Localizar o workflow ou nó aberto no momento

Clique em no ícone image no canto superior direito do painel Project Directory para localizar rapidamente o workflow ou nó aberto no momento na árvore de diretórios.

3. Pesquisar um workflow ou nó

Use a barra de pesquisa acima do painel Project Directory para encontrar um workflow ou nó específico por nome, ID do nó, proprietário ou outros critérios.

A pesquisa exibe no máximo 2.048 resultados.

4. Pesquisar um nó por trecho de código

Clique em no ícone image no canto superior direito do painel Project Directory para pesquisar nós que contenham um trecho de código específico. Para mais informações, consulte Code search.

Operações em lote em workflows e nós

Importante

As operações em lote estão disponíveis apenas no DataWorks Standard Edition e edições superiores.

No dia a dia de desenvolvimento e operações, pode ser necessário realizar ações repetitivas como:

  • Alteração de proprietário: quando um membro do projeto muda, é preciso reatribuir um grande número de nós ou recursos a um novo proprietário.

  • Migração ou alteração de ambiente: quando os recursos de computação ou armazenamento subjacentes mudam, como source de dados ou grupos de recursos de agendamento, é necessário atualize as configurações de todas as tarefas de Data Integration relacionadas.

  • Ajuste de propriedades de agendamento: devido a mudanças nos requisitos de negócio, pode ser necessário modifique o ciclo de agendamento, as propriedades de reexecução ou outras configurações de um grupo de tarefas.

  • Implantação ou remoção em massa: ao lançar um novo módulo, é preciso implantar vários nós relacionados no ambiente de produção simultaneamente.

As operações em lote permitem execute a mesma ação em múltiplos workflows, nós independentes e nós dentro de um workflow de uma só vez — como alterar o proprietário, modifique configurações de agendamento ou implantar em massa.

  1. Acesse a página de operação em lote

    Clique em no ícone Batch Operation image à direita de Project Directory para abrir a página de operação em lote. Se você selecione um diretório, a operação em lote incluirá o Directory por padrão.

    A página de operação em lote permite filtrar nós por Node Name/ID, Node Type e Owner. Os resultados são exibidos em uma tabela com o nome, tipo, diretório, status de implantação, proprietário e data de criação do nó. Selecione os nós na tabela e clique em Batch Operation na parte inferior para execute uma ação.

  2. Filtrar e selecione objetos

    Na página Batch Operation, utilize os filtros para localizar rapidamente os objetos que precisa gerencie.

    • Filtrar: use a barra de pesquisa no topo da lista e o ícone Filter image para filtrar com precisão a lista de objetos com base em critérios como Directory, Node Type, Owner ou Computing Resource for Scheduling.

      Você pode edite seus filtros favoritos na janela pop-up de filtros para exibi-los diretamente acima da lista, facilitando o acesso rápido.
    • Selecione: na lista, marque as caixas de seleção dos objetos que deseja modifique.

      Nota : Ao selecione um workflow, clique em no ícone de dropdown ao lado dele para rapidamente Select Parent Node and All Child Nodes .
  3. Execute uma operação em lote

    Após selecione os objetos desejados, clique em no botão Batch Operation no canto inferior esquerdo da página e escolha uma ação específica no menu.

    Dependendo da ação escolhida, uma caixa de diálogo será exibida. Configure as definições e clique em OK. As operações mais comuns incluem:

    • Change Owner (requer permissões de Workspace Administrator)

    • Modifying Data Integration Tasks (permite alterar a source de dados, o destino, o grupo de recursos para execução, etc.)

    • Modify scheduling configuration (permite alterar o ciclo de agendamento, dependências, grupo de recursos, etc.)

    • Deploy/Downline Release

Observações

  • Escopo de efeito: as alterações realizadas na página de operação em lote afetam apenas o ambiente de desenvolvimento. Para aplicar as alterações ao ambiente de produção, como propriedades de agendamento modificadas, é necessário implantá-las no Operation Center.

  • Modificação forçada: se algum dos objetos em modificação estiver bloqueado por outro usuário, o sistema solicita a confirmação sobre Forcefully Modify File Locked By Another User. Essa ação sobrescreve as alterações não salvas do outro usuário. Utilize esta opção com cautela e somente após confirme com os colegas envolvidos.

Visualize histórico de operações

Para revisar o histórico de operações em lote, clique em no botão Batch Operation History no canto superior direito da página. É possível visualize os detalhes de cada operação, incluindo tipo, objetos afetados, status de execução e horário.