安装和升级
在本指南中，您可以了解如何安装和升级 PyMongoArrow。
系统兼容性
PyMongoArrow 定期在 macOS 和 Linux (Ubuntu 20.04) 上构建和测试。
Python 兼容性
PyMongoArrow 与 CPython 版本 3.9、3.10、3.11、3.12 和 3.13 兼容。
安装
您可以通过以下三种方式安装 PyMongoArrow
Pip
Conda
从源代码
使用 Pip 安装
我们建议在所有平台上使用 pip 安装 PyMongoArrow。PyMongoArrow 可在PyPI.
python -m pip install pymongoarrow
获取特定版本的 pymongo
python -m pip install pymongoarrow==1.0.1
使用 pip 升级
python -m pip install --upgrade pymongoarrow
重要
如果由于错误（例如）安装失败，则表示 pip 无法为您所在的平台找到合适的 wheel，例如ValueError: Could not find "libbson-1.0" library，则意味着 pip 未安装 >= 20.3。要升级 pip，请运行以下 shell 命令
$ python -m pip install --upgrade pip
然后您可以尝试重新安装 pymongoarrow。
我们目前为 macOS、Windows 和 Linux 的 x86_64 架构提供轮子。
使用 Conda 安装
PyMongoArrow 通过以下 shell 命令为 conda 用户提供支持
$ conda install --channel conda-forge pymongoarrow
从源代码安装
如果您无法使用上述选项在您的系统上安装 pymongoarrow，则可以从源代码安装。有关如何操作，请参阅贡献指南。
依赖项
PyMongoArrow 需要以下依赖项
PyMongo 版本 4.4 或更高版本
PyArrow 版本 17.0 或更高版本
在 Linux 上从源安装需要以下额外依赖项
GCC 版本 12 或更高版本
CMake
pkg-config
要使用 PyMongoArrow 与需要可选依赖项的 PyMongo 功能，您必须在安装 PyMongo 时将依赖项设置为选项。
注意
有关 PyMongo 的可选依赖项的更多信息，请参阅 PyMongo 文档中的 依赖项。
例如，要使用 PyMongoArrow 与客户端字段级加密功能，除了安装 PyMongoArrow，您还必须安装带有 encryption 选项的 PyMongo。
python -m pip install 'pymongo[encryption]' pymongoarrow
使用 PyMongoArrow API 并将查询结果集作为 pandas.DataFrame 实例返回的应用程序（例如，~pymongoarrow.api.find_pandas_all()），也必须安装 pandas。
python -m pip install pandas