Instale o PyODPS

O PyODPS é o SDK Python para MaxCompute. Ele oferece operações básicas em objetos do MaxCompute e um framework DataFrame para análise de dados com Python. Use o PyODPS no DataWorks ou em ambiente local. Este tópico aborda a instalação em ambiente local.

Pré-requisitos

Antes de começar, verifique se você tem:

Python 3,6 ou posterior instalado
Uma conta Alibaba Cloud com um AccessKey de usuário RAM (usado para autenticação no projeto MaxCompute)

Instale o PyODPS.

Linux/macOS
```
pip3 install pyodps
```
Windows
```
pip install pyodps
```
Nota
Se ocorrer um erro de compilação C durante a instalação — geralmente causado por versões desatualizadas do pip ou setuptools — atualize-os antes de tentar novamente:
```
# Linux/macOS
pip3 install -U pip setuptools

# Windows
pip install -U pip setuptools
```
Verifique a instalação.

Linux/macOS
```
python3 -c "from odps import ODPS"
```
Windows
```
python -c "from odps import ODPS"
```
A ausência de saída indica que a instalação foi bem-sucedida. Se houver erro, consulte Solução de problemas.

Defina variáveis de ambiente

O AccessKey funciona como credencial de identidade para acessar um projeto MaxCompute. Armazene-o como variável de ambiente em vez de codificá-lo diretamente no código.

Faça login no console do Resource Access Management (RAM), copie seu AccessKey ID e AccessKey secret e siga as etapas correspondentes ao seu sistema operacional.

macOS (zsh)

Abra o arquivo de configuração do zsh.

# If zsh is not installed, run: brew install zsh
vim ~/.zshrc

Adicione as linhas abaixo e substitua os espaços reservados pelos valores reais.

export ALIBABA_CLOUD_ACCESS_KEY_ID=<your-AccessKey-ID>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<your-AccessKey-secret>

Aplique as alterações.
```
source ~/.zshrc
```
Confirme se as variáveis foram definidas.
```
echo $ALIBABA_CLOUD_ACCESS_KEY_ID
echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET
```
Cada comando exibe o valor correspondente. Se algum não retornar nada, repita as etapas 2 e 3.

Para mais detalhes sobre como definir variáveis de ambiente em sistemas Linux, macOS e Windows, consulte Definir um AccessKey da Alibaba Cloud em uma variável de ambiente.

Próximos passos

Usar o PyODPS em um ambiente local para começar a desenvolver com o MaxCompute.

Solução de problemas

Erros na instalação de pacotes de dependência

Sintoma: Ocorre um erro de compilação de código C ao instalar numpy, pyarrow ou outros pacotes de dependência.

Causa: Versões desatualizadas do pip ou setuptools.

Solução: Atualize o pip e o setuptools e reinstale o PyODPS.

# Linux/macOS
pip3 install -U pip setuptools

# Windows
pip install -U pip setuptools

Conflitos de versão do pip para diferentes versões do Python

Sintoma: O PyODPS é instalado na versão incorreta do Python.

Causa: O sistema possui múltiplas versões do Python e o pip3 aponta para uma versão diferente da desejada.

Solução: Execute o pip por meio do executável específico do Python.

/home/tops/bin/python3.7 -m pip install pyodps

Substitua /home/tops/bin/python3.7 pelo caminho da instalação do Python de destino.

Erro de versão do OpenSSL no urllib3

Sintoma: A instalação falha com a mensagem urllib3 v2.0 only supports OpenSSL 1.1.1+.

Causa: A instalação do Python utiliza uma versão antiga do OpenSSL incompatível com o urllib3 v2.0.

Solução: Instale primeiro uma versão anterior do urllib3 e depois instale o PyODPS.

# Linux/macOS
pip3 install "urllib3<2.0"

# Windows
pip install "urllib3<2.0"