Instalação e atualização
Nesta página
Neste guia, você pode aprender como instalar e atualizar o PyMongoArrow.
Compatibilidade do sistema
O PyMongoArrow é criado e testado regularmente no macOS e Linux (Ubuntu 20.04).
Compatibilidade com Python
O PyMongoArrow é compatível com as versões do CPython 3.9, 3.10, 3.11, 3.12 e 3.13.
Instalação
Você pode instalar o PyMongoArow de três maneiras:
Pip
Conda
Da fonte
Instalar com Pip
Recomendamos usar o pip para instalar o PyMongoArrow em todas as plataformas. PyMongoArrow está disponível em PyPI.
python -m pip install pymongoarrow
Para obter uma versão específica do PyMongo:
python -m pip install pymongoarrow==1.0.1
Para atualizar usando pip:
python -m pip install --upgrade pymongoarrow
Importante
Se a instalação falhar devido a um erro, como ValueError: Could
not find "libbson-1.0" library
, isso significa que pip
não conseguiu encontrar um rolete adequado para sua plataforma. Recomendamos primeiro garantir que você tenha o pip
>= 20.3 instalado. Para atualizar o pip
, execute o seguinte comando de shell:
$ python -m pip install --upgrade pip
Você pode então tentar reinstalar o pymongoarrow
.
Atualmente, distribuímos discos para macOS, Windows e Linux em arquiteturas x86_64.
Instalar com Conda
O PyMongoArrow está disponível para usuários do conda
executando o seguinte comando de shell:
$ conda install --channel conda-forge pymongoarrow
Instalar da origem
Se você não puder usar as opções acima para instalar o pymongoarrow
em seu sistema, você poderá instalar a partir da origem. Para saber como, consulte o Guia de Contribuição.
Dependencies
O PyMongoArrow requer as seguintes dependências:
PyMongo versão 4.4 ou posterior
PyArrow versão 17.0 ou posterior
A instalação a partir da origem no Linux requer as seguintes dependências adicionais:
GCC versão 12 ou posterior
CCriar
pacote-config
Para usar o PyMongoArrow com um recurso do PyMongo que exige uma dependência opcional, você deve definir a dependência como uma opção ao instalar o PyMongo.
Observação
Para saber mais sobre as dependências opcionais do PyMongo, consulte Dependências na documentação do PyMongo.
Por exemplo, para usar o PyMongoArrow com o Client-Side Field Level Encryption, é necessário instalar o PyMongo com a opção encryption
, além de instalar o PyMongoArrow:
python -m pip install 'pymongo[encryption]' pymongoarrow
Os aplicativos que usam APIs PyMongoArrow que retornam conjuntos de resultados de consulta como instâncias pandas.DataFrame
, como ~pymongoarrow.api.find_pandas_all()
, também devem ter pandas
instalado:
python -m pip install pandas