Menginstal mssql-python

Driver mssql-python adalah driver Python resmi Microsoft untuk SQL Server, Azure SQL Database, Azure SQL Managed Instance, dan database SQL di Microsoft Fabric. Instal driver di Windows, Linux, atau macOS menggunakan pip atau conda.

Prasyarat

  • Driver memerlukan Python 3.10 atau yang lebih baru dan tidak mendukung versi Python sebelumnya.
  • Untuk menginstal dengan pip, gunakan manajer paket pip yang disertakan dengan Python.
  • Untuk menginstal, gunakan manajer paket conda.

Penting

Driver mssql-python menggunakan DDBC (Direct Database Connectivity), yang menggabungkan dan mengelola lapisan ODBC secara internal. Anda tidak perlu menginstal Microsoft ODBC Driver untuk SQL Server secara terpisah.

Menginstal dari PyPI

Instal driver menggunakan pip:

pip install mssql-python

Untuk meningkatkan penginstalan yang ada:

pip install --upgrade mssql-python

Untuk memasang versi tertentu:

pip install mssql-python==1.16.0

Perintah pip install mssql-python ini juga menginstal dua paket pendamping yang dibutuhkan driver saat runtime:

  • mssql-python-odbc menyertakan biner Microsoft ODBC Driver 18.
  • mssql-python-rs menyertakan runtime Rust yang mendukung bulk copy dan penyedia opt-in mssql-odbc .

Mulai dari versi 1.16.0, mssql-python menetapkan versi yang tepat untuk kedua paket. Versi sebelumnya tidak memerlukan mssql-python-rs. Untuk pin-pin berdasarkan versi, lihat Persyaratan ketergantungan.

Instal dari conda

Driver juga tersedia di saluran microsoft di Anaconda.org:

conda install -c microsoft mssql-python

Paket conda adalah paket yang berdiri sendiri. Ini mencakup binding Python, binary driver ODBC, dan runtime Rust, sehingga conda menginstal satu paket daripada tiga. Menjalankan pip list di lingkungan masih menampilkan mssql-python-odbc dan mssql-python-rs, karena paket conda mencakup metadata paket mereka. Conda memilih build yang sesuai dengan platform dan versi Python Anda, serta mengelola upgrade:

conda update -c microsoft mssql-python

Instal driver dengan conda atau pip di lingkungan tertentu, bukan keduanya.

Paket conda memiliki persyaratan platform berikut:

Platform Versi Python Requirement
Windows x64 3.10 hingga 3.15 None.
Windows ARM64 3.12 hingga 3.15 None.
Linux x64, Linux ARM64 3.10 hingga 3.15 glibc 2.34 dan versi berikutnya. Gunakan pip pada Red Hat Enterprise Linux (RHEL) 8, Alpine Linux, dan distribusi lain dengan glibc lama atau dengan MUSL.
macOS Intel, macOS Apple Silicon 3.10 hingga 3.15 macOS 15 dan versi yang lebih baru. Koneksi terenkripsi memerlukan OpenSSL terpasang di sistem, seperti yang dijelaskan di macOS. Driver tidak memuat OpenSSL dari lingkungan conda.

Memverifikasi penginstalan

Setelah instalasi, pastikan driver berfungsi:

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}")

Output yang diharapkan:

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

Catatan khusus platform

Windows

Driver didistribusikan sebagai wheel siap pakai yang mencakup semua komponen yang diperlukan.

Linux

Driver memerlukan pustaka sistem tertentu untuk autentikasi Kerberos dan pemuatan dinamis. Instal menggunakan pengelola paket distribusi Anda:

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

Pada RHEL 8 dan distribusi lain yang kompatibel dengan glibc 2.28 (AlmaLinux 8, Rocky Linux 8), driver diinstal dari paket wheel standar manylinux_2_28 yang dipublikasikan di PyPI.

Linux Alpine:

apk add libltdl krb5-libs libstdc++

macOS

Driver didistribusikan sebagai universal2 fat binary yang berjalan secara native pada Mac berbasis Apple Silicon (arm64) maupun Intel (x86_64). Anda tidak memerlukan instalasi unixODBC terpisah.

Driver membutuhkan OpenSSL. Instal dengan menggunakan Homebrew:

brew install openssl

Jika Anda mengalami kesalahan terkait SSL, pastikan OpenSSL ditautkan dengan benar:

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

Lingkungan virtual

Untuk menghindari konflik, instal paket Python di lingkungan virtual:

# 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

Instalasi untuk pengembangan

Untuk menginstal driver beserta dependensi pengembangan guna berkontribusi terhadap pengembangan driver:

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

Memecahkan masalah penginstalan

Perintah "pip install" gagal dengan pesan "tidak ada distribusi yang sesuai"

Pastikan Anda menggunakan Python 3.10 atau lebih baru:

python --version

Jika Anda menggunakan versi Python yang lebih lama, tingkatkan Python atau gunakan pyenv untuk mengelola beberapa versi.

Kesalahan impor setelah instalasi

Jika Anda melihat ModuleNotFoundError: No module named 'mssql_python', verifikasi bahwa Anda menggunakan lingkungan Python yang sama tempat Anda menginstal paket.

pip show mssql-python

Kesalahan izin di Linux/macOS

Jika Anda mengalami kesalahan izin, hindari menggunakan sudo pip. Sebagai gantinya, gunakan lingkungan virtual atau bendera --user .

pip install --user mssql-python

Konten terkait

  • Terakhir diperbarui pada