Установка mssql-django

Пакет mssql-django — это официальная серверная часть базы данных Django, поддерживаемая Microsoft для SQL Server, База данных SQL Azure, Управляемый экземпляр SQL Azure и базы данных SQL в Microsoft Fabric. В этой статье объясняется, как установить пакет и его зависимости.

Необходимые условия

  • Python 3.8 или более поздней версии. Для Django 6.0 требуется Python версии 3.12 и более поздних версий.
  • Диспетчер пакетов pip (включен в Python версии 3.4 и более поздних версий)
  • Microsoft драйвер ODBC 17 или 18 для SQL Server. См. раздел "Скачать драйвер ODBC для SQL Server".

Important

В отличие от драйвера mssql-python, для mssql-django требуется внешний драйвер ODBC. Установите драйвер ODBC Microsoft для SQL Server перед настройкой проекта Django.

Установка из PyPI

Установите пакет с помощью pip. Эта команда также устанавливает Django, pyodbc и pytz автоматически:

pip install mssql-django

Чтобы обновить существующую установку, выполните приведенные далее действия.

pip install --upgrade mssql-django

Установка конкретной версии:

pip install mssql-django==1.7.4

Совместимость зависимостей и версий

Для mssql-django версии 1.7.4 метаданные пакета включают следующие ограничения зависимостей:

Компонент Руководство по версиям
Python 3.8 или более поздние версии
Django >=3.2 и <6.1.
pyodbc >=3.0
pytz Установлено как зависимость

Tip

Позвольте pip определить совместимые версии, если у вас нет проверенного lock-файла. Закрепление более старой pyodbc версии может привести к проблемам среды выполнения даже при успешной установке.

Проверка установки

После установки убедитесь, что пакет установлен правильно:

pip show mssql-django

Ожидаемые выходные данные:

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

Проверьте установку из Python, проверив уровень ODBC:

import pyodbc

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

Note

Серверная mssql-django часть автоматически настраивается в системе маршрутизации баз данных Django. Не импортируйте его непосредственно в код приложения. Вместо этого установите для ENGINE значение mssql в конфигурации DATABASES.

Использование виртуальной среды

Используйте виртуальную среду Python для изоляции зависимостей проекта:

python -m venv .venv

Активируйте виртуальную среду:

.venv\Scripts\activate

Затем установите mssql-django в виртуальной среде:

pip install mssql-django

Заметки по особенностям платформы

Действия по установке драйвера ODBC зависят от операционной системы.

Windows

Установите Microsoft драйвер ODBC 18 для SQL Server с помощью установщика .msiскачать драйвер ODBC для SQL Server.

Линукс

Установите драйвер ODBC с помощью диспетчера пакетов дистрибутива. См. Установка драйвера Microsoft ODBC для SQL Server (Linux), чтобы получить инструкции для конкретных платформ.

macOS

Установите драйвер ODBC с помощью Homebrew:

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

Зависимости

Пакет mssql-django автоматически устанавливает следующие зависимости:

Пакет Purpose
Django Веб-платформа
pyodbc Драйвер базы данных ODBC для Python
pytz Поддержка часового пояса

Бэкенд внутренне импортирует pytz, чтобы преобразовывать значения datetime, содержащие информацию о часовом поясе, при работе с SQL Server, поэтому pytz остаётся обязательной зависимостью времени выполнения, даже если ваш проект Django использует USE_TZ=True вместе со стандартным библиотечным модулем zoneinfo.

Связанный контент

  • Last updated on