安装和升级
在本指南中，您可以了解如何安装和升级 PyMongoArrow。
系统兼容性
PyMongoArrow 会定期在 macOS 和 Linux (Ubuntu 20.04) 上进行构建和测试。
Python 兼容性
PyMongoArrow 与 CPython 版本 3.9 、 3.10 、 3.11 、 3.12 和 3.13 兼容。
安装
您可以通过三种方式安装PyMongoArrow ：
点
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
重要
如果安装因错误而失败，例如 ValueError: Could
not find "libbson-1.0" library ，则表示pip无法为您的平台找到合适的轮子。 我们建议您首先确保已安装pip >= 20.3。 要升级pip ，请运行以下 shell 命令：
$ python -m pip install --upgrade pip
然后，您可以尝试重新安装pymongoarrow 。
我们目前为 x86_64 架构上的 macOS、Windows 和 Linux 分发轮子。
使用 Conda 安装
通过运行以下 shell 命令， conda用户可以使用 PyMongoArrow：
$ conda install --channel conda-forge pymongoarrow
从源代码安装
如果无法使用上述选项在系统上安装pymongoarrow ，您可以从源代码安装。 要学习；了解方法，请参阅 贡献指南。
Dependencies
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