安装 mssql-django

mssql-django 包是微软官方支持的 Django 数据库后端，适用于 SQL Server、Azure SQL 数据库、Azure SQL 托管实例 和 Microsoft Fabric 中的 SQL 数据库。 本文介绍如何安装包及其依赖项。

先决条件

• Python 3.8 或更高版本。 Django 6.0 需要Python 3.12 及更高版本。
• pip 包管理器（Python 3.4 及更高版本随附）
• 适用于 SQL Server 的 Microsoft ODBC Driver 17 或 18。 请参阅下载适用于 SQL Server 的 ODBC 驱动程序。

从 PyPI 安装

使用 pip 安装包。 此命令还会自动安装 Django、pyodbc 和 pytz：

pip install mssql-django

升级现有安装：

pip install --upgrade mssql-django

安装特定版本：

pip install mssql-django==1.7.3

依赖项和版本兼容性

对于 mssql-django 1.7.3，包元数据包括以下依赖项约束：

验证安装

安装后，请验证包是否已正确安装：

pip show mssql-django

预期输出：

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

从 Python 中通过测试 ODBC 层来验证安装情况：

import pyodbc

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

使用虚拟环境

使用Python虚拟环境隔离项目依赖项：

python -m venv .venv

激活虚拟环境：

.venv\Scripts\activate

source .venv/bin/activate

然后在虚拟环境中安装 mssql-django ：

pip install mssql-django

特定于平台的注释

ODBC 驱动程序安装步骤因操作系统而异。

Windows操作系统

使用来自 下载适用于 SQL Server 的 ODBC 驱动程序 的 .msi 安装程序安装 Microsoft ODBC Driver 18 for SQL Server。

Linux

使用分发的包管理器安装 ODBC 驱动程序。 有关特定于平台的说明，请参阅安装适用于 SQL Server（Linux）的 Microsoft ODBC 驱动程序。

macOS

使用 Homebrew 安装 ODBC 驱动程序：

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

依赖关系

该 mssql-django 包会自动安装以下依赖项：

pytz 保持包依赖项，以便兼容，但大多数新式 Django 时区工作流与 Django 的内置时区处理一起使用 USE_TZ=True 。

相关内容

• 快速入门：将 Django 连接到 SQL Server
• mssql-django 配置参考
• 使用 mssql-django 进行容器和本地开发
• 下载 SQL Server 的 ODBC 驱动程序
• Django 安装指南