安裝PyODPS - MaxCompute

PyODPS是MaxCompute的Python版本的SDK，提供對MaxCompute對象的基本操作及DataFrame架構，支援在MaxCompute上使用Python進行資料分析，支援在DataWorks或本地環境上使用。本文介紹在本地環境上使用PyODPS時，如何安裝PyODPS。

前提條件

安裝PyODPS環境前，需要安裝3.6或以上版本的Python。

安裝PyOPDS

進入終端命令列，執行如下命令安裝PyODPS。

# windows系統，請使用pip install pyodps
pip3 install pyodps

執行如下命令檢查安裝是否成功。若無傳回值和報錯資訊表示安裝成功。
```
# windows系統，請使用python -c "from odps import ODPS"
python3 -c "from odps import ODPS"
```

設定環境變數

需擷取阿里雲RAM帳號的ACCESS_KEY，作為讀取MaxCompute專案的身份憑證。安全起見，推薦設定環境變數。

說明

此處操作以使用zsh的macOS系統為例，設定全域環境變數。Linux、macOS、Window系統更多設定方法，請參見在環境變數中設定阿里雲AccessKey。

登入RAM控制台擷取AccessKey ID 和 AccessKey Secret。

開啟並編輯設定檔。

-- 使用zsh的macOS。如未安裝，請先執行brew install zsh
vim ~/.zshrc

-- 在開啟的檔案中，添加如下兩行環境變數。

-- 將<ACCESS_KEY_ID>替換為您自己的AccessKey ID
export ALIBABA_CLOUD_ACCESS_KEY_ID=yourAccessKeyID

-- 將<ACCESS_KEY_SECRET>替換為您自己的AccessKey Secret
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=yourAccessKeySecret

重新載入設定檔，使更改立即生效。
```
source ~/.zshrc
```

驗證環境變數設定是否成功。

echo $ALIBABA_CLOUD_ACCESS_KEY_ID
echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET

後續步驟

完成PyOPDS的安裝和環境變數準備後，可在本地環境使用PyODPS開發。

常見安裝問題

依賴包安裝錯誤

如果在安裝過程中出現numpy或者pyarrow等依賴包安裝錯誤，通常顯示為C代碼編譯錯誤，這可能是pip或者setuptools版本過低導致，可以先升級pip和setuptools的版本，再嘗試安裝。

# windows系統，請使用pip install -U pip setuptools
pip3 install -U pip setuptools

Python 版本的 pip 版本混淆

如果使用的Python不是系統預設的Python版本，可以執行如下命令以使用需要的Python版本。

/home/tops/bin/python3.7 -m pip install pyodps
#/home/tops/bin/python3.7為安裝的python路徑

urllib3 的 OpenSSL 版本報錯

如果在安裝過程中遇到urllib3 v2.0 only supports OpenSSL 1.1.1+的報錯，說明Python使用了較舊版本的OpenSSL，而試圖安裝的依賴urllib3不支援這個OpenSSL版本，此時需要先安裝舊版urllib3，此後再安裝PyODPS。

# windows系統，請使用pip install "urllib3<2.0"
pip3 install "urllib3<2.0"