将 Django 应用从其他数据库迁移到SQL Server

本文提供了将 Django 应用程序从 PostgreSQL、MySQL 或 SQLite 迁移到使用 mssql-django 后端的 SQL Server 的指导。

Overview

Django 的 ORM 提取了大多数数据库差异，但某些行为和 SQL 方言在后端之间有所不同。 本指南介绍迁移到SQL Server时遇到的主要差异。

步骤 1：安装 mssql-django

mssql-django安装包及其依赖项：

pip install mssql-django

确保已安装用于SQL Server的 Microsoft ODBC 驱动程序。 有关特定于平台的说明，请参阅 安装 mssql-django 。

步骤 2：更新 DATABASE 配置

将 settings.py 中现有的数据库配置替换为：

# Example: From PostgreSQL
# DATABASES = {
#     "default": {
#         "ENGINE": "django.db.backends.postgresql",
#         "NAME": "mydb",
#     },
# }

# To SQL Server
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：创建新的迁移

从SQL Server的干净迁移历史记录开始：

# Remove existing migration files (keep __init__.py)
# Then regenerate
python manage.py makemigrations
python manage.py migrate

与 PostgreSQL 的主要区别

待替换的 PostgreSQL 特有功能

如果您的代码使用了来自 django.contrib.postgres 的 PostgreSQL 特有功能，请将其替换掉：

# PostgreSQL ArrayField - replace with JSONField or related table
# Before
from django.contrib.postgres.fields import ArrayField
tags = ArrayField(models.CharField(max_length=50))

# After (using JSONField)
tags = models.JSONField(default=list)

# PostgreSQL HStoreField - replace with JSONField
# Before
from django.contrib.postgres.fields import HStoreField
metadata = HStoreField()

# After
metadata = models.JSONField(default=dict)

与 MySQL 的主要区别

与 SQLite 的主要区别

排序规则差异

排序规则控制 SQL Server 如何比较和排序文本。 这是从 PostgreSQL 或 MySQL 迁移时最常见的意外行为源之一。

事例敏感性

SQL Server的默认排序规则 （SQL_Latin1_General_CP1_CI_AS） 不区分大小写。 PostgreSQL 默认区分大小写。

这种行为意味着，迁移后，先前区分 "Smith" 和 "smith" 的查询会将它们视为相等：

# On PostgreSQL: returns only exact case matches
# On SQL Server (default collation): returns both "Smith" and "smith"
User.objects.filter(last_name="Smith")

如果应用程序依赖于区分大小写的比较，有两个选项：

• 将数据库或列排序规则更改为区分大小写的变体：

  -- Database-level (affects all new columns)
  ALTER DATABASE [<your-database>] COLLATE Latin1_General_CS_AS;
  
  -- Column-level (for specific columns)
  ALTER TABLE [<your-table>]
  ALTER COLUMN [<column-name>] NVARCHAR (150) COLLATE Latin1_General_CS_AS;
  

• 在原始 SQL 中对特定查询使用 Django 的 __exact 查找功能，并覆盖排序规则

区分重音

SQL Server 的默认排序规则区分重音符（AS），这与 PostgreSQL 的行为一致。 像 é 和 e 这样的字符会被视为不同的字符。 如果需要进行不区分重音符号的比较，请使用以 _AI 结尾的排序规则。

在 mssql-django 中配置排序规则

替代数据库配置中文本字段查找的默认排序规则：

DATABASES = {
    "default": {
        "ENGINE": "mssql",
        "NAME": "<your-database>",
        "OPTIONS": {
            "driver": "ODBC Driver 18 for SQL Server",
            "collation": "Latin1_General_CS_AS",  # Case-sensitive
        },
    },
}

步骤 4：更新自定义 SQL

如果代码包含原始 SQL，请更新它以获取SQL Server语法：

# PostgreSQL syntax
# cursor.execute("SELECT * FROM products LIMIT 10 OFFSET 20")

# SQL Server syntax
cursor.execute("SELECT * FROM products ORDER BY id OFFSET 20 ROWS FETCH NEXT 10 ROWS ONLY")

常见的 SQL 语法差异：

事务隔离差异

PostgreSQL 的 READ COMMITTED 隔离级别使用 MVCC（多版本并发控制）机制。 读取器永远不会阻塞写入器，写入器也永远不会阻塞读取器。

SQL Server 默认的READ COMMITTED采用锁定机制，这意味着读取查询在等待写入事务完成时可能会被阻塞。 如果应用程序在迁移后遇到阻止增加，请考虑在数据库上启用 READ COMMITTED SNAPSHOT ：

ALTER DATABASE [<your-database>]
SET READ_COMMITTED_SNAPSHOT ON;

这会将 SQL Server 的 READ COMMITTED 更改为使用行版本控制（类似于 PostgreSQL 的 MVCC），而不是锁机制。 读者无需等待活动编写器即可看到行的最后一个提交版本。

步骤 5：迁移数据

数据迁移策略取决于数据集大小：

小型数据集（<500 MB）

使用 Django 的 dumpdata/loaddata：

# On the source database
python manage.py dumpdata --natural-foreign --natural-primary -o data.json

# Switch settings.py to SQL Server, then:
python manage.py migrate
python manage.py loaddata data.json

大型数据集（>500 MB）

对于大型迁移，请使用专用工具避免内存耗尽和超时问题。 Django 的 ORM 不是适合这种规模的大容量加载工具。 在数据迁移过程中绕过它，之后让 Django 管理数据库模式和应用程序逻辑。

迁移后验证

迁移后，验证自动递增列的标识种子一致性：

-- Check identity seed and current value for all tables
SELECT 
    TABLE_NAME,
    IDENT_SEED(TABLE_SCHEMA + '.' + TABLE_NAME) AS IdentitySeed,
    IDENT_INCR(TABLE_SCHEMA + '.' + TABLE_NAME) AS IdentityIncrement,
    IDENT_CURRENT(TABLE_SCHEMA + '.' + TABLE_NAME) AS CurrentIdentity
FROM INFORMATION_SCHEMA.TABLES
WHERE TABLE_TYPE = 'BASE TABLE'
    AND OBJECTPROPERTY(OBJECT_ID(TABLE_SCHEMA + '.' + TABLE_NAME), 'TableHasIdentity') = 1
ORDER BY TABLE_NAME;

如果 CurrentIdentity 超过 IdentitySeed + record_count，则重新分配：

DBCC CHECKIDENT ('your_table', RESEED, new_seed);

相关内容

• 将 Django 应用从 PostgreSQL 迁移到 SQL Server
• 安装 mssql-django
• Django 字段到 SQL Server 类型的映射
• mssql-django 中的限制和不支持的功能
• mssql-django 中的事务管理
• mssql-django 中的时区支持
• 带有SQL Server的 JSONField