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 dengan menggunakan pip.

Prasyarat

  • Driver memerlukan Python 3.10 atau yang lebih baru dan tidak mendukung versi Python sebelumnya.
  • Pengelola paket pip (disertakan dengan Python 3.4+).

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

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

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

  • Last updated on