설치 및 업그레이드
이 가이드에서는 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로 설치
conda 사용자는 다음 shell 명령을 실행하여 PyMongoArrow를 사용할 수 있습니다.
$ conda install --channel conda-forge pymongoarrow
소스에서 설치
위 옵션을 사용하여 시스템에 pymongoarrow 를 설치할 수 없는 경우 소스에서 설치할 수 있습니다. 방법을 학습보려면 기여 가이드를 참조하세요.
Dependencies
PyMongoArrow에는 다음과 같은 종속성이 필요합니다.
PyMongo 버전 4.4 이상
PyArrow 버전 17.0 이상
Linux 의 소스에서 설치하려면 다음과 같은 추가 종속성이 필요합니다.
GCC 버전 12 이상
C 메이크
pkg-config
선택적 종속성이 필요한 PyMongo 기능 과 함께 PyMongoArrow를 사용하려면 PyMongo 를 설치할 때 종속성을 옵션으로 설정하다 해야 합니다.
참고
PyMongo의 선택적 종속성에 학습 보려면 종속성 을 참조하세요. PyMongo 문서에서 확인할 수 있습니다.
예를 들어, 클라이언트 측 필드 레벨 암호화와 함께 PyMongoArrow를 사용하려면 PyMongoArrow 설치와 함께 encryption 옵션을 사용하여 PyMongo를 설치해야 합니다.
python -m pip install 'pymongo[encryption]' pymongoarrow
쿼리 결과 세트를 pandas.DataFrame 인스턴스로 반환하는 PyMongoArrow API를 사용하는 애플리케이션(예: ~pymongoarrow.api.find_pandas_all())에도 pandas 가 설치되어 있어야 합니다.
python -m pip install pandas