步骤1：Python环境准备

通用Python应用程序连接YashanDB需要先安装并配置Python开发环境，YashanDB Python驱动支持3.6.0及以上版本的Python。

YashanDB Python驱动支持Windows和Linux平台，本手册将分别介绍YashanDB Python驱动在这两个平台环境下的安装配置过程。

1. 下载并安装Python开发环境。

   请在官方路径中下载并安装符合上述要求版本的Python包，自行配置Python环境。

2. 验证Python环境和pip。

   安装YashanDB Python驱动需要使用pip，正常情况下pip已内置在Python中无需再次安装。

   Windows

   Linux

   在Windows系统中，可通过执行python --version命令验证Python环境是否正常，可通过执行pip3 --version命令验证是否安装pip。

   C:\>python --version
   3.6.15
   C:\>pip3 --version
   

   在Linux系统中，可通过执行python3 --version命令验证Python环境是否正常，可通过执行pip3 --version命令验证是否安装pip。

   # python3 --version
   # Python 3.6.15
   # pip3 --version
   

步骤2：安装YashanDB C驱动

Note:

使用YashanDB ODBC驱动需要先安装和配置YashanDB C驱动库。YashanDB C驱动安装文件集成在YashanDB客户端安装包中，安装时需获取对应的客户端安装包。

Windows

Linux

下载C驱动安装包

1. 参考YashanDB软件包清单获取YashanDB客户端安装包。

2. 将YashanDB客户端安装包下载并解压到本地路径，例如/home/yasdb-driver-c/。

   安装包解压后可得到C驱动所需文件：

   • C驱动的头文件：位于include文件夹中。

   • C驱动的库文件：位于lib文件夹中。

设置环境变量

将C驱动的库文件所在文件夹设置到Windows环境变量PATH中，具体操作为：

1. 右键单击系统桌面上的【此电脑】图标，选择【属性】。

2. 单击【高级系统设置】。

3. 单击【环境变量】。

4. 在【系统变量】区域，选中【Path】项，单击下方的【编辑】。

5. 单击【新建】，输入C驱动的库文件所在文件夹，例如D:\yasdb-driver-c\lib。

6. 单击【确定】保存配置。

下载C驱动安装包

1. 参考YashanDB软件包清单获取YashanDB客户端安装包。

2. 将YashanDB客户端安装包下载并解压到本地路径，例如/home/yasdb-driver-c/。

   安装包解压后可得到C驱动所需文件：

   • C驱动的头文件：位于include文件夹中。

   • C驱动的库文件：位于lib文件夹中。

设置动态库依赖路径

1. 编辑bashrc文件：

$ vi ~/.bashrc

2. 新起一行增加LD_LIBRARY_PATH搜索路径，指向C驱动的库文件所在文件夹：

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/yasdb-driver-c/lib

3. 保存并退出。

4. 刷新系统变量配置。

$ source ~/.bashrc

步骤3：安装YashanDB Python驱动

1. 依据安装手册YashanDB软件包清单获取平台对应的软件包，本手册以1.0.2版本为例进行介绍。

Note:

如需选用yaspy驱动包，Windows平台应选择yaspy-xx.xx-cp36-cp36m-win_amd64.whl，Linux平台应选择yaspy-xx.xx-cp36-cp36m-linux-x86_64.whl或yaspy-xx.xx-cp36-cp36m-linux-aarch_64.whl。

2. 将压缩包下载到本地路径，例如/path/YASDB Python。

3. 运行pip3 install 软件包名称 指令对驱动包进行安装。

   Windows

   Linux

   C:\>pip3 install yaspy-1.0.0-cp38-cp38-win_amd64.whl
   

   Note:

   Linux平台安装驱动时需先切换至root用户。

   # pip3 install yaspy-1.0.0-cp36-cp36m-linux_x86_64.whl
   

安装成功后，Python应用程序可通过引用yaspy模块的方式对YashanDB数据库的进行访问操作。