Instal mssql-django

Paket mssql-django adalah backend basis data Django resmi yang didukung Microsoft untuk SQL Server, Azure SQL Database, Azure SQL Managed Instance, dan basis data SQL di Microsoft Fabric. Artikel ini menjelaskan cara menginstal paket dan dependensinya.

Prasyarat

  • Python 3.8 atau yang lebih baru. Django 6.0 memerlukan Python 3.12 dan versi yang lebih baru.
  • manajer paket pip (disertakan dengan Python 3.4 dan versi yang lebih baru)
  • Microsoft ODBC Driver 17 atau 18 untuk SQL Server. Lihat Mengunduh Driver ODBC untuk SQL Server.

Important

Tidak seperti driver mssql-python, mssql-django memerlukan driver ODBC eksternal. Instal Driver ODBC Microsoft untuk SQL Server sebelum mengonfigurasi proyek Django Anda.

Menginstal dari PyPI

Instal paket menggunakan pip. Perintah ini juga menginstal Django, pyodbc, dan pytz secara otomatis:

pip install mssql-django

Untuk meningkatkan penginstalan yang ada:

pip install --upgrade mssql-django

Untuk memasang versi tertentu:

pip install mssql-django==1.7.3

Dependensi dan kompatibilitas versi

Untuk mssql-django 1.7.3, metadata paket mencakup batasan dependensi ini:

Komponen Panduan Versi
Python 3.8 atau versi yang lebih baru
Django >=3.2 dan <6.1
pyodbc >=3.0
pytz Diinstal sebagai dependensi

Tip

Biarkan pip menentukan versi yang kompatibel kecuali Anda memiliki berkas lock yang sudah teruji. Menyematkan versi lama pyodbc dapat menyebabkan masalah runtime bahkan ketika penginstalan berhasil.

Memverifikasi penginstalan

Setelah penginstalan, verifikasi bahwa paket diinstal dengan benar:

pip show mssql-django

Output yang diharapkan:

Name: mssql-django
Version: 1.7.3
Summary: Django backend for Microsoft SQL Server

Verifikasi penginstalan dari Python dengan menguji lapisan ODBC:

import pyodbc

print(f"pyodbc version: {pyodbc.version}")
print(f"Available ODBC drivers: {pyodbc.drivers()}")

Note

Backend mssql-django tersebut secara otomatis dikonfigurasi di sistem perutean basis data Django. Jangan mengimpornya langsung dalam kode aplikasi. Sebagai gantinya, atur ENGINE ke mssql dalam konfigurasi DATABASES Anda.

Menggunakan lingkungan virtual

Gunakan lingkungan virtual Python untuk mengisolasi dependensi proyek:

python -m venv .venv

Aktifkan lingkungan virtual:

.venv\Scripts\activate

Kemudian instal mssql-django di dalam lingkungan virtual:

pip install mssql-django

Catatan khusus platform

Langkah-langkah penginstalan driver ODBC bervariasi menurut sistem operasi.

Windows

Instal Microsoft ODBC Driver 18 untuk SQL Server menggunakan .msi penginstal dari Unduh Driver ODBC untuk SQL Server.

Linux

Instal driver ODBC menggunakan manajer paket distribusi Anda. Lihat Menginstal driver ODBC Microsoft untuk SQL Server (Linux) untuk instruksi khusus platform.

macOS

Instal driver ODBC dengan Homebrew:

brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18

Ketergantungan

Paket mssql-django secara otomatis menginstal dependensi berikut:

Package Kegunaan
Django Kerangka kerja web
pyodbc Driver basis data ODBC untuk Python
pytz Dukungan zona waktu

pytz tetap menjadi dependensi paket untuk kompatibilitas, tetapi sebagian besar alur kerja zona waktu Django modern digunakan USE_TZ=True dengan penanganan zona waktu bawaan Django.

Konten terkait

  • Last updated on