mssql-django 설치

mssql-django 패키지는 SQL Server, Azure SQL Database, Azure SQL Managed Instance 및 Microsoft Fabric의 SQL 데이터베이스용으로 Microsoft가 공식 지원하는 Django 데이터베이스 백엔드입니다. 이 문서에서는 패키지 및 해당 종속성을 설치하는 방법을 설명합니다.

사전 요구 사항

• Python 3.8 이상. Django 6.0에는 Python 3.12 이상 버전이 필요합니다.
• pip 패키지 관리자(Python 3.4 이상 버전 포함)
• Microsoft SQL Server용 ODBC 드라이버 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

종속성 및 버전 호환성

1.7.3의 경우 mssql-django 패키지 메타데이터에는 다음과 같은 종속성 제약 조건이 포함됩니다.

설치 확인

설치 후 패키지가 올바르게 설치되었는지 확인합니다.

pip show mssql-django

예상 출력:

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

ODBC 계층을 테스트하여 Python 설치를 확인합니다.

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

Download ODBC Driver for SQL Server에서 .msi 설치 관리자를 사용하여 Microsoft ODBC Driver 18 for SQL Server를 설치합니다.

리눅스

배포판의 패키지 관리자를 사용하여 ODBC 드라이버를 설치합니다. 플랫폼별 지침은 Microsoft ODBC driver for SQL Server(Linux) 설치를 참조하세요.

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 설치 가이드