
出于安全考虑,生产环境通常与互联网隔离,因此无法在线安装DolphinDB Python API。本文将介绍如何在离线环境中安装Python API,包括使用conda环境和wheel安装两种方法。用户可根据生产环境的使用需求、应用场景自行选择。
一、环境准备
需要准备一个构建环境,包括在线环境和离线环境。在线环境用于收源,离线环境用于安装和测试Python API。
对于Linux环境,建议使用虚拟化工具如VirtualBox创建相似的主机环境。假设在KyLin v10, x86-64, Python 3.8的目标环境中安装Python API,需要准备的在线和离线环境如下:
对于Windows环境,需要准备两台机器,一台用于在线获取资源,另一台用于离线安装测试。有关Windows下conda环境的安装和配置,请参见相关教程。
二、Linux Conda安装
1. 安装Miniconda
推荐使用Miniconda,因为生产环境通常比较复杂,需要虚拟环境以保证隔离性。安装Miniconda后,激活base虚拟环境。
2. 配置Miniconda
分别在在线环境和离线环境配置conda,设置包路径等。
3. 在线环境下载包
在在线环境中使用conda创建虚拟环境,并下载依赖包。将包压缩后上传至离线环境的包路径。
4. 离线安装conda环境
上传压缩包并校验完整性后,解压至pkgs目录,创建虚拟环境。
5. 安装DolphinDB Python API
下载whl包,并根据CPU架构、操作系统从官方网站下载对应的Python API安装包。使用pip离线安装。
6. 验证安装是否成功
通过python命令导入dolphindb模块并创建session,验证安装是否成功。
三、Linux Wheel安装
1. 在线环境收集wheel包
使用pip wheel命令收集相关whl包。
2. 离线环境安装wheel包
将收集到的whl包上传至离线环境,并使用pip install命令安装。
3. 安装后验证
验证whl包和Python API的安装情况。
四、Windows Conda安装
分别在在线环境和离线环境安装并配置好Miniconda环境。通过在线环境构建dolphinDB依赖包和dolphinDB wheel包,并上传至离线环境完成安装。
五、Windows Wheel安装
配置一个与目标环境相同的构建环境。收集Python API的wheel包并生成清单文件requirements.txt。将相关whl包和requirements.txt上传至Python离线环境,并使用pip install命令安装。最后验证安装情况。
在Python环境中验证安装情况
在C盘Python API目录下执行pip list命令,可以看到已安装的包及其版本信息,如dolphindb 1.30.19.2、numpy 1.22.3等。为了验证dolphindb是否安装成功,我们可以尝试导入dolphindb模块并连接服务器。通过运行python hello_ddb.py,如果输出“Welcome to DolphinDB!”,则说明安装已经成功。
从安装过程来看,wheel包安装相对简单快捷,而conda安装虽然能构建隔离环境但步骤稍多。
关于安装方式的优缺点比较:
Conda
优点:提供虚拟环境,可以隔离不同项目之间的依赖关系。
不足:整个安装包大小约为500M,上传至生产环境耗时较长,且需要校验完整性。
Wheel
优点:简单快捷,安装包小。
不足:无法提供虚拟环境,可能与现有的Python环境存在冲突。
附录
7.1 常用命令
pip list:列出当前安装的包。
pip freeze packageA:列出packageA的依赖信息。
pip wheel packageA:构建packageA的依赖wheel包。
pip search packageA:在官方仓库PyPI搜索packageA。
7.2 Conda常用命令
离线创建虚拟环境:conda create -n py38 python=3.8.13 –offline。
激活/关闭虚拟环境:conda env list(查看所有虚拟环境)、conda activate py38(激活py38)、conda deactivate(退出当前虚拟环境)。
清理并删除conda环境:先停用环境,再移除所有内容。
7.3 常见问题处理
Q:Conda离线安装缺失包如何处理?
A:检查pkgs_dirs设置是否正确,确保所需包存在于该目录下。注意目录结构,不能有中间目录。
Q:Wheel包未安装或安装失败怎么办?
A:使用pip安装wheel包或尝试重新构建wheel包。如遇到问题,可手动收集特定包并上传至离线环境。
Q:Python API安装失败怎么办?
