本文为您介绍在依赖普通的Python脚本和开源三方包的场景下,如何使用DataWorks PyODPS节点调用第三方包。
背景信息
- DataWorks支持可视化创建Python资源,若需要依赖开源第三方包,请使用独享调度资源组并通过运维助手进行安装。
- DataWorks运维助手中安装的Python第三方包,仅支持在DataWorks独享调度资源组本地运行PyODPS任务代码时引用,如果需要在MaxCompute的Python UDF中引用Python第三方包,详情请参见UDF示例:Python UDF使用第三方包。
- 如果您的PyODPS任务需要访问特殊的网络环境(如VPC网络或IDC网络中的数据源或服务等),请使用独享调度资源组,并参考网络连通解决方案打通独享资源组与目标环境的网络连通。
- PyODPS语法及更多信息请参见PyODPS文档。
- PyODPS节点分为PyODPS 2和PyODPS 3两种,二者的区别在于底层Python语言版本不同。PyODPS 2底层Python语言版本为Python 2,PyODPS 3底层Python语言版本为Python 3,请您根据实际使用的Python语言版本创建PyODPS节点。更多创建PyODPS节点信息,请参见创建PyODPS 2节点和创建PyODPS 3节点。
使用限制
- 在PyODPS节点中调用第三方包仅支持使用独享调度资源组。创建及使用独享调度资源组,详情请参见独享调度资源组。
- DataWorks建议您在PyODPS节点内获取到本地处理的数据不超过50 MB,该操作受限于DataWorks执行资源的不同规格(包括公共调度资源组和独享调度资源组),处理的本地数据过多并超出操作系统阈值时可能发生OOM(Got killed)错误。请避免在PyODPS节点中写入过多的数据处理代码。详情请参见高效使用PyODPS最佳实践。
- 如果您发现有Got killed报错,即表明内存使用超限,进程被中止。因此,请尽量避免本地的数据操作。通过PyODPS发起的SQL和DataFrame任务(除to_pandas外)不受此限制。
- 非自定义函数代码可以使用平台预装的Numpy和Pandas。不支持其他带有二进制代码的三方包。
- 由于兼容性原因,在DataWorks中,options.tunnel.use_instance_tunnel默认设置为False。如果需要全局开启instance tunnel,需要手动将该值设置为True。
依赖普通的Python脚本
进入数据开发页面。
登录DataWorks控制台,单击左侧导航栏的 ,在下拉框中选择对应工作空间后单击进入数据开发。
- 创建Python资源。
- 在DataStudio(数据开发)页面,鼠标悬停至
图标,单击 。
您也可以展开业务流程目录下的目标业务流程,右键单击MaxCompute,选择。 - 在新建资源对话框中,输入名称(示例为pyodps_packagetest.py)。重要 资源名称只能包含中文、字母、数字、点、下划线(_)、减号(-),且必须加后缀名.py。
- 单击新建。
- 在新建的Python资源中,输入需要引用的第三方包的代码,示例如下。
# import os # print os.getcwd() # print os.path.abspath('.') # print os.path.abspath('..') # print os.path.abspath(os.curdir) def printname(): print 'test2' print 123
- 单击工具栏中的
图标。
- 在DataStudio(数据开发)页面,鼠标悬停至
- 创建PyODPS 2节点。
- 展开业务流程目录下的目标业务流程,右键单击MaxCompute,选择 。
- 在新建节点对话框中,输入名称(示例为pyodps_testpackage)。说明 节点名称必须是大小写字母、中文、数字、下划线(_)和小数点(.),且不能超过128个字符。
- 单击确认。
- 打开PyODPS 2节点的编辑页面,右键单击目标Python资源名称,选择引用资源。引用后,PyODPS 2节点中会自动写入引用语句
##@resource_reference{"pyodps_packagetest.py"}
。 - 在PyODPS 2节点内输入引用第三方包的代码,示例如下。
##@resource_reference{"pyodps_packagetest.py"} #用于引用之前新建的Python资源,该语句必须添加。 import sys import os sys.path.append(os.path.dirname(os.path.abspath('pyodps_packagetest.py'))) #引入资源至工作空间。 import pyodps_packagetest #引用资源,资源名需要删除后缀.py。 pyodps_packagetest.printname() #调用方法。
- 单击工具栏中的
图标,在页面下方的运行日志区域查看结果。
依赖开源的三方包
如果您依赖一个开源的三方包,需要使用PIP安装,且需要满足以下条件:
- 必须使用独享调度资源组,详情请参见新增和使用独享调度资源组。
- 在独享调度资源组的运维助手中安装需要的三方包,详情请参见运维助手。PyODPS节点分为PyODPS 2和PyODPS 3:
- 如果依赖PyODPS 2节点,请执行如下命令。
pip install <需要安装的包> -i https://pypi.tuna.tsinghua.edu.cn/simple
执行命令后,如果提示需要升级PIP版本,请执行如下命令。pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
- 如果依赖PyODPS 3节点,请执行如下命令。
/home/tops/bin/pip3 install <需要安装的包> -i https://pypi.tuna.tsinghua.edu.cn/simple
安装了需要的三方包后,使用
import
命令导入对应包即可使用。例如,通过运维助手使用pip3 -install oss2
语句安装了oss2这个Python依赖包后,您可以在PyODPS 3节点中使用import oss2
语句导入oss2依赖包并使用。执行命令后,如果提示需要升级PIP版本,请执行如下命令。/home/tops/bin/pip3 install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
如果使用PyODPS 3出现如下报错,请提交工单申请开启权限。"/home/admin/usertools/tools/cmd-0.sh:行3: /home/tops/bin/python3: 没有那个文件或目录"
- 如果依赖PyODPS 2节点,请执行如下命令。