Installer PyODPS

PyODPS est le SDK Python pour MaxCompute. Il propose des opérations de base sur les objets MaxCompute et un framework DataFrame pour l'analyse de données en Python. Utilisez PyODPS dans DataWorks ou en local. Cette rubrique explique comment procéder à l'installation en local.

Prérequis

Avant de commencer, vérifiez que vous disposez des éléments suivants :

Python 3.6 ou version ultérieure installé
Un compte Alibaba Cloud avec un AccessKey d'utilisateur RAM (utilisé pour l'authentification auprès de votre projet MaxCompute)

Installez PyODPS.

Linux/macOS
```
pip3 install pyodps
```
Windows
```
pip install pyodps
```
Remarque
Si une erreur de compilation C survient lors de l'installation, souvent due à des versions obsolètes de pip ou setuptools, mettez-les à jour avant de réessayer :
```
# Linux/macOS
pip3 install -U pip setuptools

# Windows
pip install -U pip setuptools
```
Vérifiez l'installation.

Linux/macOS
```
python3 -c "from odps import ODPS"
```
Windows
```
python -c "from odps import ODPS"
```
L'absence de sortie confirme la réussite de l'installation. En cas d'erreur, consultez la section Dépannage.

Définir les variables d'environnement

Votre AccessKey sert d'identifiant pour accéder à un projet MaxCompute. Stockez-le dans une variable d'environnement plutôt que de le coder en dur dans votre script.

Connectez-vous à la console Resource Access Management (RAM), copiez votre ID AccessKey et votre secret AccessKey, puis suivez les étapes adaptées à votre système d'exploitation.

macOS (zsh)

Ouvrez le fichier de configuration zsh.

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

Ajoutez les lignes suivantes en remplaçant les espaces réservés par vos valeurs réelles.

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

Appliquez les modifications.
```
source ~/.zshrc
```
Confirmez que les variables sont définies.
```
echo $ALIBABA_CLOUD_ACCESS_KEY_ID
echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET
```
Chaque commande affiche la valeur correspondante. Si rien ne s'affiche, répétez les étapes 2 et 3.

Pour plus de détails sur la définition des variables d'environnement sous Linux, macOS et Windows, consultez la rubrique Définir un AccessKey Alibaba Cloud dans une variable d'environnement.

Étapes suivantes

Utiliser PyODPS dans un environnement local pour commencer à développer avec MaxCompute.

Dépannage

Erreurs d'installation des packages de dépendance

Symptôme : Une erreur de compilation C apparaît lors de l'installation de numpy, pyarrow ou d'autres packages de dépendance.

Cause : pip ou setuptools est obsolète.

Solution : Mettez à jour pip et setuptools, puis réinstallez PyODPS.

# Linux/macOS
pip3 install -U pip setuptools

# Windows
pip install -U pip setuptools

Conflits de version pip pour différentes versions Python

Symptôme : PyODPS s'installe sur la mauvaise version Python.

Cause : Le système dispose de plusieurs versions Python et pip3 cible une version différente de celle souhaitée.

Solution : Appelez pip via l'exécutable Python spécifique.

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

Remplacez /home/tops/bin/python3.7 par le chemin d'accès à votre installation Python cible.

Erreur de version OpenSSL urllib3

Symptôme : L'installation échoue avec le message urllib3 v2.0 only supports OpenSSL 1.1.1+.

Cause : Votre installation Python utilise une version OpenSSL plus ancienne incompatible avec urllib3 v2.0.

Solution : Installez d'abord une version antérieure de urllib3, puis installez PyODPS.

# Linux/macOS
pip3 install "urllib3<2.0"

# Windows
pip install "urllib3<2.0"