PyODPS のインストール

PyODPS は、MaxCompute 向けの Python ソフトウェア開発キット (SDK) です。MaxCompute オブジェクトの基本操作と、Python ベースのデータ分析を可能にするデータフレーム (DataFrame) フレームワークを提供します。PyODPS は DataWorks またはローカル環境で使用できます。このトピックでは、ローカル環境で使用するために PyODPS をインストールする方法について説明します。

前提条件

Python 3.6 以降がインストールされていることを確認してください。

コマンドラインターミナルを開き、次のコマンドを実行して PyODPS をインストールします。
```
# Windows の場合は、pip install pyodps を使用します
pip3 install pyodps
```
次のコマンドを実行して、インストールを検証します。値やエラーメッセージが返されなければ、インストールは成功です。
```
# Windows の場合は、python -c "from odps import ODPS" を使用します
python3 -c "from odps import ODPS"
```

環境変数の設定

Alibaba Cloud の Resource Access Management (RAM) ユーザーの AccessKey を取得します。この AccessKey は、MaxCompute プロジェクトにアクセスするための ID 認証情報として機能します。セキュリティのため、環境変数として設定してください。

説明

このセクションでは、macOS システムで zsh を使用する例を挙げて、グローバル環境変数を設定する方法を説明します。Linux、macOS、および Windows システムで環境変数を設定する方法の詳細については、「環境変数に Alibaba Cloud AccessKey を設定する」をご参照ください。

Resource Access Management (RAM) コンソールにログインして、AccessKey ID と AccessKey Secret を取得します。

設定ファイルを開いて編集します。

-- macOS (zsh) の場合。zsh がインストールされていない場合は、先に brew install zsh を実行してください。
vim ~/.zshrc

-- 以下の 2 行をファイルに追加します。

-- <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

次のステップ

PyODPS をインストールして環境変数を設定したら、開発のためにローカル環境で PyODPS を使用できます。

よくあるインストール時の問題

依存パッケージのインストールエラー

numpy や pyarrow などの依存パッケージをインストールする際にエラーが発生した場合、通常は C コードのコンパイルエラーが表示されます。これは、pip または setuptools のバージョンが古いことが原因である可能性があります。pip と setuptools をアップグレードしてから、インストールを再試行してください。

# Windows の場合は、pip install -U pip setuptools を使用します
pip3 install -U pip setuptools

異なる Python バージョン間での pip のバージョン競合

システムのデフォルトの 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 が urllib3 依存関係と互換性のない古いバージョンの OpenSSL を使用していることを示しています。この場合は、まず古いバージョンの urllib3 をインストールしてから、PyODPS をインストールしてください。

# Windows の場合は、pip install "urllib3<2.0" を使用します
pip3 install "urllib3<2.0"