mssql-python yükleme

Sürücü, mssql-python Microsoft Server, Azure SQL Veritabanı, Azure SQL Yönetilen Örneği ve Microsoft Fabric'teki SQL veritabanı için Microsoft'un resmi Python sürücüsüdür. Sürücüyü Windows, Linux veya macOS üzerinde pip veya conda kullanarak yükleyin.

Prerequisites

  • Sürücü Python 3.10 veya daha yeni sürümleri gerektirir ve önceki Python sürümlerini desteklemez.
  • pip ile kurulum yapmak için, Python ile birlikte gelen pip paket yöneticisini kullanın.
  • Conda ile kurmak için, conda paket yöneticisini kullanın.

Important

mssql-python sürücüsü, ODBC katmanını dahili olarak paketleyip yöneten DDBC (Direct Database Connection) kullanır. SQL Server için Microsoft ODBC Sürücüsünü ayrı olarak yüklemenize gerek yok.

PyPI'dan yükleme

Sürücüyü pip kullanarak yükleyin:

pip install mssql-python

Mevcut bir yüklemeyi yükseltmek için:

pip install --upgrade mssql-python

Belirli bir sürümü yüklemek için:

pip install mssql-python==1.16.0

Komut pip install mssql-python ayrıca sürücünün çalışma zamanında ihtiyaç duyduğu iki eşlik paketini yükler:

  • mssql-python-odbc Microsoft ODBC Driver 18 ikili dosyaları ile birlikte gelir.
  • mssql-python-rs toplu kopya ve isteğe bağlı mssql-odbc sağlayıcısını güçlendiren Rust çalışma zamanını içerir.

1.16.0 sürümünden itibaren, mssql-python her iki paketin tam versiyonlarını pinler. Önceki sürümler mssql-python-rs gerektirmez. Sürümlere göre sabitlemeler için bkz. Bağımlılık gereksinimleri.

conda'dan kurulum

Sürücü ayrıca microsoft üzerindeki kanalda da mevcuttur:

conda install -c microsoft mssql-python

Conda paketi bağımsız bir pakettir. Python bağlamalarını, ODBC sürücü ikili dosyalarını ve Rust çalışma zamanını içerir, böylece conda üç yerine bir paket kurar. Ortamda çalıştırıldığında hâlâ mssql-python-rs ve mssql-python-odbc gösterilir, çünkü conda paketi onların paket meta verilerini içerir. Conda, platformunuza ve Python sürümüne uygun derlemeyi seçer ve yükseltmeleri yönetir:

conda update -c microsoft mssql-python

Sürücüyü belirli bir ortamda ya conda ya da pip ile kurun, ikisini birden değil.

Conda paketi şu platform gereksinimlerini içermektedir:

Platform Python sürümleri Requirement
Windows x64 3.10'dan 3.15'e kadar None.
Windows ARM64 3.12'den 3.15'e kadar None.
Linux x64, Linux ARM64 3.10'dan 3.15'e kadar glibc 2.34 ve sonraki sürümler. Red Hat Enterprise Linux (RHEL) 8, Alpine Linux ve eski bir glibc’ye sahip veya musl kullanan diğer dağıtımlarda pip kullanın.
macOS Intel, macOS Apple Silicon 3.10'dan 3.15'e kadar macOS 15 ve daha sonraki sürümler. Şifreli bağlantılar için, macOS'ta açıklandığı gibi sistemde OpenSSL kurulu olmalıdır. Sürücü, conda ortamından OpenSSL yüklemez.

Yüklemeyi doğrulama

Kurulumdan sonra sürücünün çalıştığını doğrulayın:

import mssql_python

print(f"mssql-python version: {mssql_python.__version__}")
print(f"DB-API level: {mssql_python.apilevel}")
print(f"Thread safety: {mssql_python.threadsafety}")
print(f"Parameter style: {mssql_python.paramstyle}")

Beklenen çıkış:

mssql-python version: 1.16.0
DB-API level: 2.0
Thread safety: 1
Parameter style: pyformat

Platforma özgü notlar

Windows

Sürücü, gerekli tüm bileşenleri içeren önceden hazırlanmış bir tekerlek olarak gönderilir.

Linux

Sürücü, Kerberos kimlik doğrulaması ve dinamik yükleme için belirli sistem kütüphaneleri gerektirir. Dağıtımınızın paket yöneticisi ile kurun:

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install libltdl7 libkrb5-3 libgssapi-krb5-2

Red Hat/CentOS/Fedora:

sudo dnf install libtool-ltdl krb5-libs

Note

RHEL 8 ve diğer glibc 2.28 uyumlu dağıtımlarda (AlmaLinux 8, Rocky Linux 8), sürücü PyPI'ye yayımlanan standart manylinux_2_28 çarktan yüklenir.

Alpine Linux:

apk add libltdl krb5-libs libstdc++

macOS

Sürücü, Apple Silicon (arm64) ve Intel (x86_64) Mac'lerde yerel olarak çalışan bir universal2 binary olarak geliyor. Ayrı bir unixODBC kurulumuna ihtiyacınız yok.

Sürücü OpenSSL gerektirir. Homebrew kullanarak kurun:

brew install openssl

SSL ile ilgili hatalarla karşılaşırsanız, OpenSSL'nin doğru şekilde bağlandığından emin olun:

export LDFLAGS="-L/opt/homebrew/opt/openssl/lib"
export CPPFLAGS="-I/opt/homebrew/opt/openssl/include"

Sanal ortamlar

Çatışmaları önlemek için, Python paketlerini sanal bir ortamda kurun:

# Create a virtual environment
python -m venv .venv

# Activate it (Windows)
.venv\Scripts\activate

# Activate it (Linux/macOS)
source .venv/bin/activate

# Install the driver
pip install mssql-python

Geliştirme kurulumu

Sürücüye katkıda bulunmak için geliştirme bağımlılıkları olan sürücüyü yüklemek için:

git clone https://github.com/microsoft/mssql-python.git
cd mssql-python
pip install -e ".[dev]"

Yükleme sorunlarını giderin

pip install, "eşleşen dağıtım bulunamadı" hatası veriyor

Python 3.10 veya daha yeni sürümleri kullandığınızdan emin olun:

python --version

Eski bir Python sürümü kullanıyorsanız, Python'u yükseltin veya birden fazla sürümü yönetmek için pyenv kullanın.

Kurulumdan sonra aktarma hatası

Eğer görürsenizModuleNotFoundError: No module named 'mssql_python', paketi kurduğunuz aynı Python ortamını kullandığınızı doğrulayın.

pip show mssql-python

Linux/macOS'ta izin hataları

Eğer izin hatalarıyla karşılaşırsanız, sudo pip kullanmaktan kaçının. Bunun yerine sanal bir ortam veya bayrak --user kullanın.

pip install --user mssql-python

İlgili içerik

  • Son güncelleştirme: