インストールとアップグレード
このガイドでは、PyMongoArrow をインストールおよびアップグレードする方法を学習できます。
システムの互換性
PyMongoArrow は、macOS および Linux（Ubuntu 20.04）で定期的にビルドおよびテストされています。
Python 互換性
PyMongoArrow は CPython バージョン 3.9 、 3.10 、 3.11 、 3.12 、および 3.13 と互換性があります。
インストール
PyMongoArrowは、次の 3 つの方法でインストールできます。
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
重要
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 を使用したインストール
PyMongoArrow は、次の shell コマンドを実行することで、 condaユーザーが利用できます。
$ conda install --channel conda-forge pymongoarrow
ソースからインストール
上記のオプションを使用してシステムにpymongoarrowをインストールできない場合は、ソースからインストールできます。 その方法については、「 貢献ガイド 」を参照してください。
Dependencies
PyMongoArrow には次の依存関係が必要です。
PyMongo バージョン4.4以降
PyArrow バージョン 17.0 以降
Linux に ソースから をインストールするには、次の追加の依存関係が必要です。
GCC バージョン12以降
CMax
pkg-config
オプションの依存関係を必要とする PyMongo 機能で PyMongoArrow を使用するには、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