导入并配置HetuEngine Python3样例工程
本章节适用于MRS 3.3.0及以后版本。
操作场景
为了运行FusionInsight MRS产品HetuEngine组件的Python3样例代码，需要完成下面的操作。
操作步骤
- 客户端机器必须安装有Python3，其版本不低于3.6，最高不能超过3.9。
在客户端机器的命令行终端输入python3可查看Python版本号。如下显示Python版本为3.8.2。
Python 3.8.2 (default, Jun 23 2020, 10:26:03) [GCC 4.8.5 20150623 (Red Hat 4.8.5-36)] on linux Type "help", "copyright", "credits" or "license" for more information.
- 客户端机器必须安装有setuptools。
通过官方网站下载软件，下载地址：https://pypi.org/project/setuptools/#files。
将下载的setuptools压缩文件复制到客户端机器上，解压后进入setuptools项目目录，在客户端机器的命令行终端执行python3 setup.py install。
以47.3.1版本为例，如下内容表示安装setuptools的47.3.1版本成功。
Finished processing dependencies for setuptools==47.3.1
若提示setuptools的47.3.1版本安装不成功，则需要检查环境是否有问题或是Python自身原因导致的。
- 客户端机器必须安装有jaydebeapi，可以通过该模块使用java的JDBC来连接数据库。
可通过如下两种方式安装：
- pip安装：
- 运行脚本安装。
- 通过官方网站下载JayDeBeApi项目文件，下载地址：https://pypi.org/project/JayDeBeApi/。
- 进入JayDeBeApi项目目录执行python3 setup.py install。如果安装过程中提示python3缺少模块或者包，则需要自行进行补充。
以JayDeBeApi-1.2.3为例，提示Successfully installed JayDeBeApi-1.2.3表示已安装成功。
- 客户端机器必须安装Java，支持的版本可参考表1中的“安装JDK”。
- 获取Python3样例代码。
- 参考获取MRS应用开发样例工程，获取样例代码解压目录中“src\hetu-examples”目录下的样例工程文件夹“python3-examples”。
- 进入“python3-examples”文件夹。
- normal文件夹：普通模式下对接HetuEngine的python3样例代码
- security文件夹：安全模式下对接HetuEngine的python3样例代码。
- 获取hetu-jdbc jar包。
- 通过Manager下载客户端文件至本地获取：
- 登录FusionInsight Manager页面，选择“集群 > 服务 > HetuEngine > 更多 > 下载客户端”。
- 选择“完整客户端”，根据待安装客户端节点的节点类型选择正确的平台类型（x86选择“x86_64”，ARM选择“aarch64”），不勾选“仅保存到如下路径”，单击“确定”，等待客户端文件包自动生成并下载。
- 解压下载的软件包获取hetu-jdbc压缩包并解压获取jdbc包。
例如客户端文件压缩包为“FusionInsight_Cluster_1_Services_Client.tar”，解压后得到“FusionInsight_Cluster_1_Services_ClientConfig.tar”，继续解压该文件得到“FusionInsight_Cluster_1_Services_ClientConfig”（路径中不能有空格）。再解压“\FusionInsight_Cluster_1_Services_ClientConfig\HetuEngine\x86\hetu-jdbc.tar.gz”获取hetu-jdbc-XXX.jar，复制至样例代码运行机器上自定义路径。
- 集群客户端节点获取：
登录已安装HetuEngine客户端的节点，客户端安装路径以“/opt/hadoopclient”为例，则在“/opt/hadoopclient/HetuEngine/hetuserver/jars/”中获取hetu-jdbc-XXX.jar，复制至样例代码运行机器上自定义路径。
- 通过Manager下载客户端文件至本地获取：
