安装
在安装 dolphindb 前,请确定已部署 Python 执行环境。若无,推荐使用 Anaconda Distribution 下载 Python 及常用库。
支持版本
dolphindb 的详细版本列表和离线下载链接请参照 pypi dolphindb。下表展示 dolphindb 在不同操作系统中对应支持的 Python 版本号。
操作系统 | Python 版本号 |
---|---|
Windows(amd64) | Python 3.6-3.12 |
Linux(x86_64) | Python 3.6-3.12 |
Linux(aarch64) | Conda 环境下的 Python 3.7-3.12 |
Mac(x86_64) | Conda 环境下的 Python 3.6-3.12 |
Mac(arm64) | Conda 环境下的 Python 3.8-3.12 |
注意:为保证正常使用 dolphindb ,您需要同时安装以下依赖库:
- future
- NumPy(版本号不得低于 1.18,建议不高于 2.0)
- pandas(版本号不得低于 1.0.0,建议不高于 2.2.0,暂不支持 1.3.0)
- packaging
- 扩展依赖:PyArrow(版本号不得低于 9.0.0)
安装示例
目前仅支持通过 pip
指令安装 DolphinDB Python API,暂不支持 conda
安装。安装示例如下:
$ pip install dolphindb
常见问题
Q1:安装失败,或安装成功后无法导入 dolphindb 包。
A1:建议检查并重装 whl 包。具体操作如下:
通过 PyPI 确认是否存在支持当前操作系统(例如 Linux arm 架构、Mac ARM 等)的 DolphinDB API 安装包。若存在,则将该 whl 包下载至本地。
通过如下命令查看适合当前系统环境支持的 whl 包后缀。
pip debug --verbose
根据 Compatible tags 的显示信息,将 DolphinDB 的 whl 包名修改为适合系统架构的名称。以 Mac(x86_64) 系统为例:安装包名为 "dolphindb-1.30.19.2-cp37-cp37m-macosx_10_16_x86_64.whl"。但查询到 pip 支持的当前系统版本为10.13,则将 whl 包名中的“10_16”替换成“10_13”。
尝试安装更名后的 whl 包。
Q2:无法导入 dolphindb 包,出现如下错误提示:
ImportError:DLL load failed while importing dolphindbcpp:找不到指定的模块。
A2:DolphinDB Python API 依赖一些动态库。从报错信息上看,可能是缺失了 msvcp140.dll。按照如下方法安装 Visual C++ redistributable 包即可正常导入 dolphindb 包。
如果使用的是 Windows 64-bit, 请从以下链接下载并安装 x86 和 x64 版本的 Visual C++ redistributable 包:
vc_redist.x64.exe(x64 安装程序)
vc_redist.x86.exe(x86 安装程序)
若执行完上述操作后,仍无法安装或导入,可在 DolphinDB 社区中进行反馈。