# 导入并配置HetuEngine Python3样例工程
#### 操作场景
为了运行HetuEngine组件的Python3样例代码，需要完成下面的操作。
#### 约束与限制
本章节适用于MRS 3.3.0及以后版本。
#### 操作步骤
1. 客户端机器必须安装有Python3，其版本不低于3.6，最高不能超过3.9。 
   在客户端机器的命令行终端输入**python** **3** 可查看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.
   ```
   
   
2. 客户端机器必须安装有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
   ```
   ![](https://support.huaweicloud.com/devg-lts-mrs/public_sys-resources/note_3.0-zh-cn.png)
   若提示setuptools的47.3.1版本安装不成功，则需要检查环境是否有问题或是Python自身原因导致的。
   
   
3. 客户端机器必须安装有JayDeBeApi，可以通过该模块使用java的JDBC来连接数据库。 
   可通过如下两种方式安装：
   - pip安装： 在客户端节点执行**pip install JayDeBeApi**。如果安装过程中提示缺少依赖的其他模块，则需要自行下载安装。
     
   
   - 运行脚本安装。
     1. 通过官方网站下载JayDeBeApi项目文件，下载地址：<https://pypi.org/project/JayDeBeApi/>。
     
     2. 进入JayDeBeApi项目目录执行**python3 setup.py install** 。如果安装过程中提示python3缺少模块，则需要自行进行补充。
        以JayDeBeApi-1.2.3为例，提示Successfully installed JayDeBeApi-1.2.3表示已安装成功。
        
      
    
   
   
4. 客户端机器必须安装Java，支持的版本可参考[表1](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_100006.html#mrs_07_100006__zh-cn_topic_0254454679_table59078165)中的"安装JDK"。
5. 获取Python3样例代码。 
   1. 参考[获取MRS应用开发样例工程](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_010002.html)，获取样例代码解压目录中"src\\hetu-examples"目录下的样例工程文件夹"python3-examples"。
   
   2. 进入"python3-examples"文件夹。
      - normal文件夹：普通模式下对接HetuEngine的python3样例代码
      
      - security文件夹：安全模式下对接HetuEngine的python3样例代码。
       
   
   
   
   
6. 获取hetu-jdbc jar包。 
   - 通过Manager下载客户端文件至本地获取：
     1. 登录FusionInsight Manager页面，选择"集群 \> 服务 \> HetuEngine \> 更多 \> 下载客户端"。
     
     2. 选择"完整客户端"，根据待安装客户端节点的节点类型选择正确的平台类型（x86选择"x86_64"，ARM选择"aarch64"），不勾选"仅保存到如下路径"，单击"确定"，等待客户端文件包自动生成并下载。
     
     3. 解压下载的软件包获取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，复制至样例代码运行机器上自定义路径。