个人目录是为每位开发者提供的私有存储与开发空间,用于代码的管理和调试。您可以在此目录中创建和维护个人代码。
个人目录说明
个人目录下的文件分为两类:我的文件和本地文件。以下为这两种文件类型的介绍:
目录类型 | 存储目录 | 存储提供方 | 存储路径 | 是否允许终端直接操作文件 |
我的文件 | 个人目录下默认存在的目录。 | DataWorks | —— | 否 |
本地文件 | 使用个人开发环境时,个人开发环境实例的默认存储目录。 说明 需要先创建个人开发环境实例。 | 个人开发环境实例指定数据集时,存储提供方为数据集配置的NAS服务。 | 在创建个人开发环境实例时指定。 | 是 |
个人开发环境实例未指定数据集时,存储提供方为DataWorks。 |
| 是 | ||
未使用个人开发环境时,支持将用户当前操作设备上的路径添加到个人目录下。 | 用户当前操作设备 | 以实际添加本地文件夹时选择的路径为准。 | 否 |
文件类型
个人目录下创建的文件类型无限制,但仅支持运行以下类型的文件:
.ipynb
:Notebook文件。.sh
:Shell文件。.py
:Python文件。.sql
:SQL文件。
个人目录可以读写Visual Studio Code
支持的其他开发语言对应的文件类型,但不提供语法提示和开发环境,不支持运行。
前提条件
进入个人目录
进入DataWorks工作空间列表页,在顶部切换至目标地域,找到已创建的工作空间,单击操作列的 ,进入Data Studio。
在Data Studio页面左侧导航栏单击
按钮,进入数据开发页面后,单击左侧目录树中的个人目录,进入个人目录。
添加个人文件
您可以按需选择添加个人文件位置及方式。
新建个人文件
在个人目录中单击我的文件,然后在工具栏选择图标可快速在我的文件下创建个人文件。创建时需指定文件后缀以确定文件类型,支持的文件类型及其说明,请参见文件类型。
您也可以单击图标,规划我的文件下的目录结构。
添加本地文件
除了使用个人目录默认提供的我的文件目录外,您还可以将本地文件夹(包括文件夹内的文件、代码库等)直接添加至个人目录中进行管理。
未使用个人开发环境时,在工具栏单击
图标,将本地(您当前操作设备)文件夹添加到个人目录,按需选择目标文件夹。
该操作需要您授权浏览器读取本地文件相关权限。
使用个人开发环境时,在工具栏单击
图标,将本地(个人开发环境实例)文件夹添加到个人目录,按需选择目标文件夹。
编辑个人文件
添加完个人文件后,您可以通过单击文件名进入编辑页面,并开始编辑文件内容。例如,在 .sql
文件中编写SQL语句。如下所示:
SELECT * FROM dw_work WHERE work_title IS NOT NULL;
使用个人文件
您可参照下文使用个人文件,其中:
在个人目录支持运行的文件类型中,
.sql
文件和.py
文件可以指定将代码下发至空间绑定的计算资源执行。个人目录支持的文件类型(
.ipynb
、.sh
、.py
、.sql
)可以提交到项目目录运行,并配置调度属性发布至生产环境。个人目录下的
.py
文件支持提交为MaxCompute的资源或函数,在MaxCompute作业开发时使用。
方式一:在个人目录下运行
这种方式适合日常开发、测试和临时查询。在开发过程中,您需要测试一小段代码逻辑是否按预期工作,可以在个人目录下创建临时文件来测试代码。
配置调试参数。
在个人目录下,找到需要运行的
Shell
、Python
或SQL
文件,单击进入编辑页面,在右侧的调试配置中设置任务运行参数。参数
说明
类型
选择执行文件所需的计算资源类型。
计算资源
选择当前空间下已绑定的计算资源。
资源组
选择执行文件使用的资源组。
Notebook文件需运行在个人开发环境中,详情请参见运行Notebook。
调试运行代码。
在文件详情页面,单击工具栏中的
按钮即可快速运行任务。
方式二:提交至项目目录运行
若个人目录下的代码需要在生产环境中周期性调度执行,可以通过提交到项目目录的功能,基于个人文件快速创建调度节点,并按照项目目录的流程创建周期任务,完成后续的开发操作。
进入提交流程。
在个人目录下找到需要提交至项目目录的文件,双击文件名打开文件详情。在文件顶部工具栏中,单击
按钮将文件提交至项目目录。
配置提交参数。
配置
描述
选择节点类型
选择将个人文件提交为项目目录中的节点类型。请注意,当前代码需与所选节点类型匹配。
选择创建节点所属的路径
选择节点在项目目录中的存储路径。
确定节点名称
确认是否使用个人文件名作为节点名,或重新定义节点名。
方式三:将Python文件提交为资源或函数
Data Studio支持将个人目录中的.py
文件提交为MaxCompute的资源或函数,以便在数据开发节点中使用。
进入提交流程。
在个人目录下找到需要提交至项目目录的
.py
文件,双击文件名打开文件详情。在文件顶部工具栏中,单击按钮后的下拉菜单,选择提交为函数或提交为资源。
配置提交参数。
配置
描述
类型
选择提交为函数时,类型默认为
MaxCompute Function
。选择提交为资源时,类型默认为
MaxCompute Python
。
路径
选择资源或函数在资源管理中的路径。默认为
/
,表示存放在资源管理的根目录,如需调整,请先到资源管理中手动创建目录后,再在此处选择。提交类型
新建:在资源管理指定路径下创建新的函数或资源,选择此参数时,需要配置资源或函数名称。
关联旧文件:选择关联的已有资源或函数,选择此参数时,需要配置已存在资源。
当关联已有函数时,将使用当前
.py
文件中的Python代码替换原函数中的代码。当关联已有资源时,将使用当前
.py
文件替换原资源中的文件内容。
单击确认后,根据页面提示完成后续操作。
如果提交类型选择为新建,则会进入对应资源或函数的创建页面。
如果提交类型选择为关联旧文件,则会进入已有函数或资源的编辑页面。
MaxCompute函数和资源的配置参数详细说明,请参见MaxCompute资源与函数。
管理个人文件
个人目录下的文件,均可以通过文件右键菜单进行管理,例如下载文件至本地,删除文件、重命名文件。
针对个人开发环境的文件,除上述方式外,您还可以通过终端进行管理。
在集成终端中打开
在本地文件目录下,找到目标文件并右键单击,在弹出的菜单中选择在集成终端中打开,此操作将快速打开终端窗口,并自动定位到该文件。
将本地文件夹添加到个人目录
在本地文件目录下,找到目标文件并右键单击,在弹出的菜单中选择将本地文件夹添加到个人目录...,可快速将您通过终端创建的文件加载至个人目录。
将本地文件夹从个人目录删除
在本地文件目录下,找到目标文件并右键单击,在弹出的菜单中选择将本地文件夹从个人目录删除...,此操作可快速将个人目录下的文件移除,但不会彻底删除该文件。
附录:个人目录界面功能
Data Studio个人目录具体支持的操作如下:
界面功能 | 功能描述 |
将本地文件夹添加到个人目录。
| |
新建Notebook。 | |
新建文件。 | |
新建文件夹。 | |
刷新。 | |
收起文件夹。 |