django-mssql-backend에서 mssql-django로 마이그레이션

이 문서에서는 sql_server.pyodbc 엔진을 사용하던 django-mssql-backend 패키지에서 mssql-django 패키지로 Django 프로젝트를 마이그레이션하는 방법을 설명합니다.

Overview

mssql-django 패키지는 django-mssql-backend의 후속 패키지입니다. pyodbc를 사용하여 SQL Server 위한 Django 데이터베이스 백 엔드를 계속 제공하지만 업데이트된 패키지 이름, 엔진 식별자 및 최신 Django 버전에 대한 지원을 제공합니다.

1단계: Python 패키지 업데이트

이전 패키지를 제거하고 새 패키지를 설치합니다.

pip uninstall django-mssql-backend
pip install mssql-django

requirements.txt 파일을 사용하는 경우 패키지 참조를 바꾸세요:

# Before
django-mssql-backend>=2.8.1

# After
mssql-django>=1.7

2단계: 엔진 업데이트 DATABASE

settings.py에서 ENGINE 값을 sql_server.pyodbc에서 mssql(으)로 변경합니다:

# Before
DATABASES = {
    "default": {
        "ENGINE": "sql_server.pyodbc",
        "NAME": "<your-database>",
        "USER": "<your-username>",
        "PASSWORD": "<your-password>",
        "HOST": "<your-server>",
        "PORT": "1433",
        "OPTIONS": {
            "driver": "ODBC Driver 17 for SQL Server",
        },
    },
}

# After
DATABASES = {
    "default": {
        "ENGINE": "mssql",
        "NAME": "<your-database>",
        "USER": "<your-username>",
        "PASSWORD": "<your-password>",
        "HOST": "<your-server>",
        "PORT": "1433",
        "OPTIONS": {
            "driver": "ODBC Driver 18 for SQL Server",
        },
    },
}

3단계: INSTALLED_APPS 업데이트

INSTALLED_APPS에서 sql_server을 참조하는 경우 업데이트하세요:

# Before
INSTALLED_APPS = [
    "sql_server",
    # ...
]

# After - only needed if using inspectdb
INSTALLED_APPS = [
    "mssql",
    # ...
]

4단계: 구성 확인

빠른 확인을 실행하여 새 백 엔드가 성공적으로 연결되었는지 확인합니다.

python manage.py check
python manage.py showmigrations

5단계: 테스트 도구 모음 실행

프로젝트의 테스트 도구 모음을 실행하여 모든 것이 새 백 엔드에서 작동하는지 확인합니다.

python manage.py test

주의해야 할 주요 변경 내용

관련 콘텐츠

• mssql-django 설치
• mssql-django의 새로운 기능
• mssql-django 구성 참조