PyODPS Yükleme

PyODPS, MaxCompute için geliştirilmiş Python SDK’sıdır. MaxCompute nesneleri üzerinde temel işlemler yapmanızı ve Python tabanlı veri analitiği için bir DataFrame çerçevesi sunmanızı sağlar. PyODPS’yi DataWorks ortamında veya yerel bir ortamda kullanabilirsiniz. Bu konu, yerel ortama kurulum adımlarını kapsar.

Ön Koşullar

Başlamadan önce aşağıdaki öğelerin hazır olduğundan emin olun:

Python 3,6 veya sonraki bir sürümün yüklü olması
MaxCompute projenize kimlik doğrulaması yapmak için kullanılan bir RAM kullanıcı AccessKey’e sahip bir Alibaba Cloud hesabınızın bulunması

PyODPS’yi yükleyin.

Linux/macOS
```
pip3 install pyodps
```
Windows
```
pip install pyodps
```
Not
Kurulum sırasında C derleme hatası alırsanız —bu durum genellikle eski pip veya setuptools sürümlerinden kaynaklanır— öncelikle bunları yükseltin ve ardından işlemi tekrar deneyin:
```
# Linux/macOS
pip3 install -U pip setuptools

# Windows
pip install -U pip setuptools
```
Kurulumu doğrulayın.

Linux/macOS
```
python3 -c "from odps import ODPS"
```
Windows
```
python -c "from odps import ODPS"
```
Herhangi bir çıktı görünmemesi kurulumun başarılı olduğunu gösterir. Bir hata mesajı alırsanız Sorun Giderme bölümüne bakın.

Ortam Değişkenlerini Ayarlama

AccessKey’iniz, bir MaxCompute projesine erişim için kimlik bilgisi olarak görev yapar. Bu bilgiyi kodunuzun içine sabit olarak yazmak yerine ortam değişkeni olarak saklayın.

Resource Access Management (RAM) konsoluna giriş yapın, AccessKey ID’nizi ve AccessKey secret’ınızı kopyalayın; ardından işletim sisteminize uygun adımları izleyin.

macOS (zsh)

zsh yapılandırma dosyasını açın.

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

Aşağıdaki satırları ekleyin; yer tutucuları kendi değerlerinizle değiştirin.

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

Değişiklikleri uygulayın.
```
source ~/.zshrc
```
Değişkenlerin ayarlandığını onaylayın.
```
echo $ALIBABA_CLOUD_ACCESS_KEY_ID
echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET
```
Her komut ilgili değeri ekrana yazdırır. Herhangi biri boş sonuç verirse 2. ve 3. adımları tekrarlayın.

Linux, macOS ve Windows sistemlerinde ortam değişkenlerini ayarlama hakkında daha fazla ayrıntı için bkz. Alibaba Cloud AccessKey’i ortam değişkeninde ayarlama.

Sonraki Adımlar

MaxCompute ile geliştirme yapmaya başlamak için Yerel ortamda PyODPS kullanma konusuna göz atın.

Sorun Giderme

Bağımlılık paketi yükleme hataları

Belirti: numpy, pyarrow veya diğer bağımlılık paketlerini yüklerken C kodu derleme hatası oluşur.

Neden: pip veya setuptools güncel değildir.

Çözüm: pip ve setuptools’u yükseltin, ardından PyODPS’yi yeniden yükleyin.

# Linux/macOS
pip3 install -U pip setuptools

# Windows
pip install -U pip setuptools

Farklı Python sürümleri için pip sürüm çakışmaları

Belirti: PyODPS yanlış Python sürümü üzerine yüklenir.

Neden: Sistemde birden fazla Python sürümü bulunur ve pip3 komutu hedeflenen yerine farklı bir sürümü hedef alır.

Çözüm: pip’i belirli Python çalıştırılabilir dosyası üzerinden çağırın.

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

/home/tops/bin/python3.7 yolunu hedeflediğiniz Python kurulumunun yoluyla değiştirin.

urllib3 OpenSSL sürüm hatası

Belirti: Kurulum urllib3 v2.0 only supports OpenSSL 1.1.1+ hatasıyla başarısız olur.

Neden: Python kurulumunuz, urllib3 v2.0 ile uyumsuz olan daha eski bir OpenSSL sürümü kullanır.

Çözüm: Önce daha eski bir urllib3 sürümü yükleyin, ardından PyODPS’yi yükleyin.

# Linux/macOS
pip3 install "urllib3<2.0"

# Windows
pip install "urllib3<2.0"