dukungan dan siklus hidup 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. Ini secara aktif dipertahankan pada GitHub dan dirilis melalui PyPI. Halaman ini mencakup penerapan versi, kompatibilitas platform, dan kebijakan dukungan.

Dukungan versi

Selalu gunakan rilis terbaru untuk mendapatkan fitur baru, peningkatan performa, dan perbaikan keamanan. Kemampuan baru hanya ditambahkan ke rilis saat ini.

Versi saat ini

Versi 1.7.3 adalah rilis ketersediaan umum (GA) saat ini.

Definisi status dukungan

Gunakan nilai status ini dalam tabel versi:

Status Meaning
Saat ini Menerima fitur baru, perbaikan bug, dan perbaikan keamanan.
Sebelumnya Rilis historis. Tetap tersedia tetapi tidak menerima pembaruan.

Riwayat versi

Versi Tanggal rilis Status Versi Django Fitur utama
1.7.3 Juni 2026 Saat ini 3.2 - 6.0 FA001 perbaikan untuk Authentication= mode selain ActiveDirectoryMsi, perbaikan subkelas DatabaseWrapperKeyError (regresi dari 1.7.1)
1.7.2 Mei 2026 Previous 3.2 - 6.0 perbaikan zona waktu datetimeoffset, Now() perbaikan zona waktu, .explain() perbaikan kompatibilitas
1.7.1 April 2026 Previous 3.2 - 6.0 perbaikan database SQL di Fabric, perbaikan AlterField untuk indeks menurun
1.7 Maret 2026 Previous 3.2 - 6.0 Dukungan Django 6.0, ODBC Driver 18 sebagai default, dukungan SQL Server 2025
1.6 Agustus 2025 Previous 3.2 - 5.2 Dukungan Django 5.1 dan 5.2, fungsionalitas JSON yang ditingkatkan
1.5 April 2024 Previous 3.2 - 5.0 supports_comments tandai, AutoField perbaikan
1.4 Januari 2024 Previous 3.2 - 5.0 Dukungan Django 5.0, dukungan db_comment
1.3 Mei 2023 Previous 3.2 - 4.2 Dukungan Django 4.2, peka terhadap huruf besar/kecil Replace
1.2 Desember 2022 Previous 3.2 - 4.1 Dukungan Django 4.1, dukungan zona waktu, JSONField pada Azure SQL Managed Instance
1.1 Juli 2022 Previous 3.2 - 4.0 Rilis awal dengan dukungan Django 3.2 dan 4.0

Versi sebelum 1.1 adalah pra-rilis dan tidak tercantum.

Important

Perbaikan dan fitur baru hanya dikirim dalam rilis baru. Versi lama tetap tersedia di PyPI tetapi tidak di-patch di tempatnya. Untuk mendapatkan perbaikan bug atau perbaikan keamanan, tingkatkan ke rilis terbaru.

Untuk catatan rilis terperinci, lihat Apa yang baru dalam mssql-django.

Kompatibilitas versi Django dan Python

Setiap rilis Django mendukung versi Python tertentu. Saat memilih versi Anda, pastikan kompatibilitas antara Django, Python, dan mssql-django:

Versi Django Versi Python
6.0 3.12, 3.13, 3.14
5.2 3.10, 3.11, 3.12, 3.13
5.1 3.10, 3.11, 3.12, 3.13
5.0 3.10, 3.11, 3.12
4.2 3.8, 3.9, 3.10, 3.11, 3.12
4.1 3.8, 3.9, 3.10, 3.11
4.0 3.8, 3.9, 3.10
3.2 3.8, 3.9, 3.10

Important

Selalu gunakan versi Python yang didukung. Versi Python yang lebih lama tidak menerima pembaruan keamanan.

kompatibilitas versi SQL Server

Backend mssql-django berfungsi dengan semua versi SQL Server yang didukung.

Layanan Azure SQL

Pelayanan Status dukungan
Azure SQL Database Didukung sepenuhnya
Azure SQL Managed Instance Didukung sepenuhnya

Microsoft Fabric

Titik Akhir Status dukungan
Basis data SQL dalam Fabric Didukung sepenuhnya

Kompatibilitas driver ODBC

Backend mssql-django memerlukan driver ODBC eksternal, tidak seperti mssql-python driver yang menggunakan Direct Database Connectivity (DDBC).

Mulai versi mssql-django 1.7, backend secara default menggunakan ODBC Driver 18 untuk SQL Server dan otomatis beralih ke ODBC Driver 17 jika versi 18 tidak terinstal. Anda dapat mengambil alih ini dengan menentukan driver opsi dalam konfigurasi database Anda.

pengandar ODBC Status dukungan
Microsoft ODBC Driver 18 untuk SQL Server Didukung penuh (default)
Microsoft ODBC Driver 17 untuk SQL Server Didukung penuh (fallback)
Driver FREETDS ODBC Didukung

Untuk petunjuk penginstalan, lihat Mengunduh Driver ODBC untuk SQL Server.

Kompatibilitas sistem operasi

Backend mssql-django berjalan di mana saja Python dan driver ODBC didukung. Langkah-langkah penginstalan driver ODBC bervariasi menurut sistem operasi. Lihat Menginstal mssql-django untuk penyiapan khusus platform.

Sistem operasi Architecture Status dukungan
Windows 11 x64, ARM64 Didukung
Server Windows 2019, 2022, 2025 x64 Didukung
Ubuntu 22.04, 24.04 x64, ARM64 Didukung
Debian 11, 12 x64, ARM64 Didukung
Red Hat Enterprise Linux 8, 9 x64, ARM64 Didukung
macOS 14, 15 Intel, Apple Silicon (ARM64) Didukung
Alpine Linux x64 Didukung (memerlukan lapisan kompatibilitas glibc atau FreeTDS)

Kompatibilitas fitur

Tabel berikut mencantumkan fitur Django dan SQL Server dan status dukungannya di mssql-django backend. Untuk detail selengkapnya tentang fitur yang tidak didukung, lihat Batasan dan fitur yang tidak didukung di mssql-django.

Fitur ORM Django

Fitur dukungan untuk mssql-django
Migrations Yes
QuerySet Antarmuka Pemrograman Aplikasi (API) Yes
JSONField Ya (SQL Server 2016+)
bulk_create / bulk_update Yes
Transaksi database Yes
inspectdb dengan --schema Yes
DISTINCT ON No
__regex / __iregex pencarian Parsial (memerlukan penyiapan rakitan CLR; tidak tersedia pada Azure SQL Database)
SmallAutoField Yes
select_for_update() Ya (NOWAIT dan SKIP_LOCKED; of tidak didukung)
Fungsi jendela Yes
GeneratedField (kolom terhitung) Ya (Django 5.0 dan yang lebih baru)
CompositePrimaryKey Parsial (Django 5.2 dan yang lebih baru; lihat batasan)
db_comment Ya (Django 4.2 dan yang lebih baru)
Mencakup indeks (include) Ya (Django 4.2 dan yang lebih baru)
NthValue No

fitur SQL Server

Fitur dukungan mssql-django
Koneksi terenkripsi (TLS) Yes
Selalu Terenkripsi Yes
Microsoft Entra otentikasi Yes
Beberapa Set Hasil Aktif (MARS) Ya (melalui pyodbc)
Prosedur yang disimpan Ya (melalui cursor.execute)
SNAPSHOT Isolasi Ya (memerlukan konfigurasi tingkat database)
Perutean baca-saja Yes

Persyaratan dependensi

Paket mssql-django secara otomatis menginstal dependensi berikut:

Ketergantungan Kegunaan Versi yang diperlukan
Django Kerangka kerja web >= 3.2
pyodbc Driver basis data ODBC untuk Python >= 3.0
pytz Dukungan zona waktu (warisan; Django modern menggunakan bawaan zoneinfo dengan USE_TZ=True) Any

Backend mssql-django juga memerlukan Driver MICROSOFT ODBC agar SQL Server diinstal pada sistem host. Untuk informasi selengkapnya, lihat Menginstal mssql-django.

Kebijakan tentang pembuatan versi dan perubahan yang menyebabkan kerusakan kompatibilitas

  • Versi minor (1.6, 1.7): Sertakan dukungan versi Django baru, fitur baru, dan perbaikan bug. Pertahankan kompatibilitas dengan versi sebelumnya.
  • Versi patch (1.7.1, 1.7.2, 1.7.3): Sertakan perbaikan bug saja.

Tim mendokumentasikan perubahan yang menyebabkan inkompatibilitas di catatan rilis. Lihat Apa yang baru dalam mssql-django untuk catatan khusus versi.

Cara tetap terkini

Backend mssql-django merilis versi baru untuk melacak rilis Django. Periksa pembaruan saat memutakhirkan Django.

Periksa versi yang terinstal

Verifikasi versi mana yang saat ini diinstal:

pip show mssql-django

Tingkatkan ke versi terbaru

Perbarui ke rilis terbaru:

pip install --upgrade mssql-django

Berlangganan pembaruan

Dapatkan dukungan

Microsoft mendukung mssql-django melalui saluran GitHub dan komunitas.

Masalah GitHub

Laporkan bug dan fitur permintaan di GitHub:

Saat melaporkan masalah, sertakan versi Django Anda, versi Python, versi SQL Server, versi driver ODBC, dan reproduksi minimal masalah.

Contribute

Kontribusi komunitas dipersilakan. Untuk informasi selengkapnya tentang Perjanjian Lisensi Kontributor (CLA) dan proses pengiriman, lihat panduan berkontribusi.

Community

Konten terkait

  • Last updated on