个人目录

个人目录是为每位开发者提供的私有存储与开发空间,用于代码的管理和调试。您可以在此目录中创建和维护个人代码。

个人目录说明

个人目录下的文件分为两类:我的文件和本地文件。以下为这两种文件类型的介绍:

目录类型

存储目录

存储提供方

存储路径

是否允许终端直接操作文件

我的文件

个人目录下默认存在的目录。

DataWorks

——

本地文件

使用个人开发环境时,个人开发环境实例的默认存储目录。

说明

需要先创建个人开发环境实例

个人开发环境实例指定数据集时,存储提供方为数据集配置的NAS服务。

在创建个人开发环境实例时指定。

个人开发环境实例未指定数据集时,存储提供方为DataWorks。

/mnt/workspace/.virtual_documents

未使用个人开发环境时,支持将用户当前操作设备上的路径添加到个人目录下。

用户当前操作设备

以实际添加本地文件夹时选择的路径为准。

文件类型

个人目录下创建的文件类型无限制,但仅支持运行以下类型的文件:

  • .ipynbNotebook文件。

  • .sh:Shell文件。

  • .py:Python文件。

  • .sql:SQL文件。

说明

个人目录可以读写Visual Studio Code支持的其他开发语言对应的文件类型,但不提供语法提示和开发环境,不支持运行。

前提条件

进入个人目录

  1. 进入DataWorks工作空间列表页,在顶部切换至目标地域,找到已创建的工作空间,单击操作列的快速进入 > Data Studio,进入Data Studio。

  2. Data Studio页面左侧导航栏单击image按钮,进入数据开发页面后,单击左侧目录树中的个人目录,进入个人目录。

添加个人文件

您可以按需选择添加个人文件位置及方式。

新建个人文件

个人目录中单击我的文件,然后在工具栏选择image图标可快速在我的文件下创建个人文件。创建时需指定文件后缀以确定文件类型,支持的文件类型及其说明,请参见文件类型

您也可以单击image图标,规划我的文件下的目录结构。

添加本地文件

除了使用个人目录默认提供的我的文件目录外,您还可以将本地文件夹(包括文件夹内的文件、代码库等)直接添加至个人目录中进行管理。

  • 未使用个人开发环境时,在工具栏单击image图标,将本地(您当前操作设备)文件夹添加到个人目录,按需选择目标文件夹。

    该操作需要您授权浏览器读取本地文件相关权限。
  • 使用个人开发环境时,在工具栏单击image图标,将本地(个人开发环境实例)文件夹添加到个人目录,按需选择目标文件夹。

编辑个人文件

添加完个人文件后,您可以通过单击文件名进入编辑页面,并开始编辑文件内容。例如,在 .sql 文件中编写SQL语句。如下所示:

SELECT * FROM dw_work WHERE work_title IS NOT NULL;

使用个人文件

您可参照下文使用个人文件,其中:

  • 在个人目录支持运行的文件类型中,.sql文件和.py文件可以指定将代码下发至空间绑定的计算资源执行。

  • 个人目录支持的文件类型(.ipynb.sh.py.sql)可以提交到项目目录运行,并配置调度属性发布至生产环境。

  • 个人目录下的.py文件支持提交为MaxCompute的资源或函数,在MaxCompute作业开发时使用。

方式一:在个人目录下运行

这种方式适合日常开发、测试和临时查询。在开发过程中,您需要测试一小段代码逻辑是否按预期工作,可以在个人目录下创建临时文件来测试代码。

  1. 配置调试参数。

    • 在个人目录下,找到需要运行的ShellPythonSQL文件,单击进入编辑页面,在右侧的调试配置中设置任务运行参数。

      参数

      说明

      类型

      选择执行文件所需的计算资源类型。

      计算资源

      选择当前空间下已绑定的计算资源。

      资源组

      选择执行文件使用的资源组。

    • Notebook文件需运行在个人开发环境中,详情请参见运行Notebook

  2. 调试运行代码。

    在文件详情页面,单击工具栏中的image按钮即可快速运行任务。

方式二:提交至项目目录运行

若个人目录下的代码需要在生产环境中周期性调度执行,可以通过提交到项目目录的功能,基于个人文件快速创建调度节点,并按照项目目录的流程创建周期任务,完成后续的开发操作。

  1. 进入提交流程。

    在个人目录下找到需要提交至项目目录的文件,双击文件名打开文件详情。在文件顶部工具栏中,单击image按钮将文件提交至项目目录。

  2. 配置提交参数。

    配置

    描述

    选择节点类型

    选择将个人文件提交为项目目录中的节点类型。请注意,当前代码需与所选节点类型匹配。

    选择创建节点所属的路径

    选择节点在项目目录中的存储路径。

    确定节点名称

    确认是否使用个人文件名作为节点名,或重新定义节点名。

方式三:将Python文件提交为资源或函数

Data Studio支持将个人目录中的.py文件提交为MaxCompute的资源或函数,以便在数据开发节点中使用。

  1. 进入提交流程。

    在个人目录下找到需要提交至项目目录的.py文件,双击文件名打开文件详情。在文件顶部工具栏中,单击image按钮后的下拉菜单,选择提交为函数提交为资源

  2. 配置提交参数。

    配置

    描述

    类型

    • 选择提交为函数时,类型默认为MaxCompute Function

    • 选择提交为资源时,类型默认为MaxCompute Python

    路径

    选择资源或函数在资源管理中的路径。默认为/,表示存放在资源管理的根目录,如需调整,请先到资源管理中手动创建目录后,再在此处选择。

    提交类型

    • 新建:在资源管理指定路径下创建新的函数或资源,选择此参数时,需要配置资源或函数名称

    • 关联旧文件:选择关联的已有资源或函数,选择此参数时,需要配置已存在资源

      • 当关联已有函数时,将使用当前.py文件中的Python代码替换原函数中的代码

      • 当关联已有资源时,将使用当前.py文件替换原资源中的文件内容

  3. 单击确认后,根据页面提示完成后续操作。

    • 如果提交类型选择为新建,则会进入对应资源或函数的创建页面。

    • 如果提交类型选择为关联旧文件,则会进入已有函数或资源的编辑页面。

    MaxCompute函数和资源的配置参数详细说明,请参见MaxCompute资源与函数

管理个人文件

个人目录下的文件,均可以通过文件右键菜单进行管理,例如下载文件至本地,删除文件、重命名文件。

针对个人开发环境的文件,除上述方式外,您还可以通过终端进行管理。

  • 在集成终端中打开

    在本地文件目录下,找到目标文件并右键单击,在弹出的菜单中选择在集成终端中打开,此操作将快速打开终端窗口,并自动定位到该文件。

  • 将本地文件夹添加到个人目录

    在本地文件目录下,找到目标文件并右键单击,在弹出的菜单中选择将本地文件夹添加到个人目录...,可快速将您通过终端创建的文件加载至个人目录。

  • 将本地文件夹从个人目录删除

    在本地文件目录下,找到目标文件并右键单击,在弹出的菜单中选择将本地文件夹从个人目录删除...,此操作可快速将个人目录下的文件移除,但不会彻底删除该文件。

附录:个人目录界面功能

Data Studio个人目录具体支持的操作如下:

界面功能

功能描述

image

将本地文件夹添加到个人目录。

  • 未使用个人开发环境时,在工具栏单击image图标,将本地(您当前操作设备)文件夹添加到个人目录,按需选择目标文件夹。

    该操作需要您授权浏览器读取本地文件相关权限。
  • 使用个人开发环境时,在工具栏单击image图标,将本地(个人开发环境实例)文件夹添加到个人目录,按需选择目标文件夹。

image

新建Notebook。

image

新建文件。

image

新建文件夹。

image

刷新。

image

收起文件夹。