Todos os produtos
Search
Central de documentação

DataWorks:Diretório pessoal

Última atualização: Jun 27, 2026

O diretório pessoal é um espaço privado para gerenciar e depurar código. Nesse diretório, você pode criar e manter seus códigos pessoais, além de compartilhar arquivos com outros workspaces ou usuários.

Visão geral do recurso

Os arquivos no diretório pessoal organizam-se em três categorias: My Files, Shared Files e Local Files. A tabela a seguir descreve essas categorias.

Tipo de diretório

Nome de exibição

Diretório de armazenamento

Provedor de armazenamento

Caminho de armazenamento

Acesso via terminal

My Files

Show My Nodes Only

Diretório padrão do diretório pessoal.

DataWorks

/

Não

Shared Files

Shared files (read-only)

Arquivos pessoais que outros usuários compartilharam com você. É possível visualizar esses arquivos, mas não editá-los.

DataWorks

/

Não

Local Files

Nota

Este diretório não existe por padrão. Adicione arquivos locais manualmente.

Nome do caminho de montagem do dataset

Ao usar um ambiente de desenvolvimento pessoal, este é o diretório de armazenamento padrão da instância do ambiente.

Se você especificar um dataset para a instância do ambiente de desenvolvimento pessoal, o provedor de armazenamento será o serviço NAS ou OSS configurado para o dataset.

Especificado durante a criação da instância do ambiente de desenvolvimento pessoal.

Sim

workspace

Se nenhum dataset for especificado para a instância do ambiente de desenvolvimento pessoal, o provedor de armazenamento será o DataWorks.

/mnt/workspace

Sim

Nome da pasta local

Se você não estiver usando um ambiente de desenvolvimento pessoal, poderá adicionar um caminho do seu dispositivo local ao diretório pessoal.

Seu dispositivo local

O caminho real selecionado ao adicionar a pasta local.

Não

Nota

O Security Center pode reger os downloads de arquivos em My Files. Um administrador de tenant ou administrador de segurança do tenant pode configurar a permissão de download de arquivos nas configurações do ambiente pessoal do Security Center. Após ativar a aprovação de download, cada solicitação precisará de aprovação antes que você possa baixar arquivos em Upload and Download.

Acessar o diretório pessoal

  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 da página Data Studio, clique em image para acessar a página de desenvolvimento de dados. Em seguida, clique em Personal Directory na árvore de diretórios à esquerda para abrir o diretório pessoal.

Gerenciar arquivos pessoais

Escolha onde e como adicionar arquivos pessoais conforme necessário.

Criar um arquivo pessoal

Em Personal Directory, clique em Show My Nodes Only. Na barra de ferramentas, clique em para criar rapidamente um arquivo SQL pessoal em My Files. Os quatro tipos de arquivo a seguir estão disponíveis por padrão e podem ser executados diretamente:

  • .sql: arquivo SQL.

  • .ipynb: arquivo Notebook.

  • .py: arquivo Python.

  • .sh: arquivo Shell.

Clique em Show My Nodes Only. Na barra de ferramentas, clique em Create File para criar rapidamente arquivos pessoais em mais formatos em My Files. Ao criar um arquivo, especifique uma extensão de arquivo para determinar o tipo de arquivo.

Nota
  • Não há restrições quanto aos tipos de arquivo que você pode criar no diretório pessoal, mas apenas os tipos listados acima podem ser executados.

  • O diretório pessoal suporta leitura e escrita de tipos de arquivo de outras linguagens de programação compatíveis com Visual Studio Code, porém não oferece sugestões de sintaxe, ambientes de desenvolvimento ou suporte de execução para esses arquivos.

Adicionar arquivos locais

Além do diretório padrão Show My Nodes Only fornecido pelo diretório pessoal, você pode adicionar pastas locais (incluindo arquivos e repositórios de código dentro das pastas) diretamente ao Personal Directory para gerenciamento.

  • Método 1: Na barra de ferramentas, clique em image para adicionar uma pasta local ao diretório pessoal e selecione a pasta de destino conforme necessário.

    Importante

    Quando o ambiente de desenvolvimento pessoal não está ativado, "local" refere-se ao seu dispositivo local, e esta operação exige que você conceda permissões ao navegador para ler arquivos locais. Quando o ambiente de desenvolvimento pessoal está ativado, "local" refere-se à instância do ambiente de desenvolvimento pessoal.

  • Método 2: Clique com o botão direito no diretório de arquivos locais e selecione Add On-premises Folder no menu de contexto.

    Se um arquivo não for mais necessário, clique com o botão direito no arquivo de destino e selecione Delete no menu de contexto. Esta operação remove o arquivo do diretório pessoal, mas não o exclui permanentemente.

Compartilhar arquivos pessoais

Compartilhe arquivos ou pastas em Show My Nodes Only com outros workspaces ou contas Alibaba Cloud para permitir que membros da equipe visualizem seus arquivos de consulta ad hoc.

  1. Em Show My Nodes Only, clique com o botão direito no arquivo ou pasta que deseja compartilhar e selecione Share no menu de contexto.

  2. Na caixa de diálogo Share, configure os seguintes parâmetros.

    Parâmetro

    Descrição

    Sharing method

    Selecione o tipo de destino para compartilhamento.

    • Workspace: Compartilha o arquivo com um workspace específico. Todos os membros do workspace podem visualizar o arquivo.

    • Alibaba Cloud account: Compartilha o arquivo com um usuário de conta Alibaba Cloud específico.

    Sharing scope

    Com base no método de compartilhamento selecionado, selecione os workspaces ou contas Alibaba Cloud de destino sob o tenant atual. Seleções múltiplas são suportadas.

Nota
  • Após o compartilhamento do arquivo, um ícone de compartilhamento aparece ao lado do arquivo na árvore de diretórios.

  • Para cancelar o compartilhamento, clique com o botão direito no arquivo, selecione Share novamente e remova os destinos de compartilhamento selecionados na caixa de diálogo.

  • Os usuários com quem os arquivos foram compartilhados podem visualizá-los na seção Shared files (read-only) de seus respectivos diretórios pessoais.

Visualizar arquivos compartilhados

Quando outros usuários compartilham arquivos pessoais com seu workspace ou conta Alibaba Cloud, visualize esses arquivos na seção Shared files (read-only) do diretório pessoal.

  • Os arquivos compartilhados agrupam-se pelo usuário que os compartilhou. Expanda um nome de usuário para ver a lista de arquivos compartilhados por ele.

  • Os arquivos compartilhados são somente leitura. Você pode abrir e visualizar o conteúdo, mas não pode editar, excluir ou renomeá-los.

Localizar arquivos

O diretório pessoal oferece vários recursos rápidos de localização de arquivos para ajudar você a encontrar facilmente o que precisa, melhorando a eficiência da busca e permitindo um gerenciamento e desenvolvimento de dados mais ágeis.

1. Localizar o workflow ou nó aberto atualmente

Clique em image ao lado de Personal Directory para localizar rapidamente o arquivo aberto no painel direito dentro do diretório do projeto.

2. Navegar rapidamente para uma pasta no terminal

No diretório de arquivos locais do ambiente de desenvolvimento pessoal, clique com o botão direito na pasta de destino e selecione Open in Integrated Terminal no menu de contexto. Isso abre uma janela de terminal e navega automaticamente para o caminho da pasta.

3. Pesquisar nós

Na caixa de pesquisa do DataStudio (acima de Project Directory), pesquise um arquivo específico pelo nome.

Podem ser exibidos no máximo 2.048 resultados de pesquisa.

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

Clique em image ao lado de Personal Directory para pesquisar nós que contenham um trecho de código específico. Para mais informações, consulte Pesquisar por trecho de código.

Utilizar arquivos pessoais

Utilize arquivos pessoais conforme descrito abaixo:

  • Dentre os tipos de arquivo executáveis no diretório pessoal, arquivos .sql e .py podem ser configurados para execução em recursos de computação associados ao workspace.

  • Os tipos de arquivo suportados no diretório pessoal (.ipynb, .sh, .py, .sql) podem ser enviados ao diretório do projeto para execução, e configurações de agendamento podem ser definidas para implantá-los no ambiente de produção.

  • Arquivos .py no diretório pessoal podem ser enviados como recursos ou funções do MaxCompute para uso no desenvolvimento de jobs do MaxCompute.

Método 1: Executar no diretório pessoal

Este método é adequado para desenvolvimento rotineiro, testes e consultas ad hoc. Durante o desenvolvimento, caso precise testar se uma pequena lógica de código funciona conforme o esperado, crie um arquivo temporário no diretório pessoal para testar o código.

  1. Configurar parâmetros de depuração

    • No diretório pessoal, localize o arquivo Shell, Python ou SQL que deseja executar e clique em para abrir a página de edição. No painel Run Configuration no lado direito, configure os parâmetros de execução da tarefa.

      Parâmetro

      Descrição

      Type

      Selecione o tipo de recurso de computação necessário para executar o arquivo.

      Compute Resource

      Selecione um recurso de computação associado ao workspace atual.

      Resource Group

      Selecione o grupo de recursos a ser usado para executar o arquivo.

    • Arquivos Notebook devem ser executados em um ambiente de desenvolvimento pessoal. Para mais informações, consulte Executar arquivos Notebook.

  2. Depurar e executar código

    Na página de detalhes do arquivo, clique em image na barra de ferramentas para executar rapidamente a tarefa.

Método 2: Enviar ao diretório do projeto para execução

Se o código no seu diretório pessoal precisar ser agendado periodicamente e executado no ambiente de produção, utilize o recurso de envio ao diretório do projeto para criar rapidamente um nó agendado com base no arquivo pessoal. Em seguida, siga o fluxo de trabalho do diretório do projeto para criar uma tarefa agendada e concluir as operações de desenvolvimento subsequentes.

  1. Iniciar o processo de envio

    No diretório pessoal, localize o arquivo que deseja enviar ao diretório do projeto e clique duas vezes no nome do arquivo para abrir os detalhes. Na barra de ferramentas na parte superior do arquivo, clique em image para enviar o arquivo ao diretório do projeto.

  2. Configurar parâmetros de envio

    Configuração

    Descrição

    Type

    Selecione o tipo de nó no diretório do projeto para o qual o arquivo pessoal será enviado. O sistema seleciona por padrão o tipo de nó correspondente ao tipo de arquivo atual.

    • Arquivo SQL: Enviado como MaxCompute SQL por padrão.

    • Arquivo Notebook: Enviado como um nó Notebook por padrão.

    • Arquivo Python: Enviado como um nó Python por padrão.

    • Arquivo Shell: Enviado como um nó Shell por padrão.

    Path

    Selecione o caminho de armazenamento para o nó no diretório do projeto.

    Name

    Especifique se deseja usar o nome do arquivo pessoal como nome do nó ou definir um novo nome para o nó.

Método 3: Enviar um arquivo Python como recurso ou função

O Data Studio permite enviar arquivos .py do diretório pessoal como recursos ou funções do MaxCompute para uso em nós de desenvolvimento de dados.

  1. Iniciar o processo de envio

    No diretório pessoal, localize o arquivo .py que deseja enviar ao diretório do projeto e clique duas vezes no nome do arquivo para abrir os detalhes. Na barra de ferramentas na parte superior do arquivo, clique em no menu suspenso ao lado de image e selecione Submit as Function ou Submit as Resource.

  2. Configurar parâmetros de envio

    Configuração

    Descrição

    Type

    • Ao selecionar Submit as Function, o tipo assume o valor padrão MaxCompute Function.

    • Ao selecionar Submit as Resource, o tipo assume o valor padrão MaxCompute Python.

    Path

    Selecione o caminho para o recurso ou função no Gerenciamento de Recursos. O caminho padrão é /, que indica o diretório raiz do gerenciamento de recursos. Para alterar o caminho, primeiro crie manualmente um diretório no gerenciamento de recursos e depois selecione-o aqui.

    Submission Type

    • Create: Cria uma nova função ou recurso sob o caminho especificado no gerenciamento de recursos. Ao selecionar esta opção, configure o Name do recurso ou função.

    • Associate With Existing File: Associa a um recurso ou função existente. Ao selecionar esta opção, configure o Existing Resource.

      • Ao associar a uma função existente, o código Python no arquivo .py atual substitui o Code da função original.

      • Ao associar a um recurso existente, o arquivo .py atual substitui o Document Content do recurso original.

  3. Clique em Confirm e siga as instruções na tela para concluir as operações subsequentes.

    • Se Submission Type estiver definido como Create, você será redirecionado para a página de criação do recurso ou função correspondente.

    • Se Submission Type estiver definido como Associate With Existing File, você será redirecionado para a página de edição da função ou recurso existente.

    Para mais informações sobre os parâmetros de configuração de funções e recursos do MaxCompute, consulte Configurar funções e recursos do MaxCompute.