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ü pip kullanarak Windows, Linux veya macOS'a yükleyin.

Prerequisites

  • Sürücü Python 3.10 veya daha yeni sürümleri gerektirir ve önceki Python sürümlerini desteklemez.
  • pip paket yöneticisi (Python 3.4+ ile birlikte dahil).

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

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

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

  • Last updated on