Django 根据配置生成 SQL 语句的完整流程

宋时安

发布时间：2026-10-13 | 2人浏览过

原创

本文详细介绍如何在 Django 中根据模型和配置生成 SQL 语句。涵盖 DATABASES 设置、INSTALLED_APPS 激活、版本差异（如 1.10 后的 check 命令替代 validate），以及新版 makemigrations、migrate 和 sqlmigrate 命令的使用，解决旧版 sqlall 和 syncdb 报错问题，帮助开发者顺利执行数据访问。

若需依据 Django 模型及配置信息生成 SQL 语句，首先需完成相关环境设置：

首先进入项目 app 目录下的 settings.py 文件，定位到 DATABASES 变量以配置数据库连接信息：

DATABASES = { 
 'default': { 
  # 'ENGINE': 'django.db.backends.sqlite3', 
  # 'NAME': os.path.join(BASE_DIR, 'db.sqlite3'), 
  'ENGINE': 'django.db.backends.mysql', 
  'NAME': '你的数据库的名字', 
  'USER': '用户名', 
  'PASSWORD': '密码', 
  'HOST': '', 
  'PORT': '3306', 
 }

随后需在 settings.py 中的 INSTALLED_APPS 列表里注册你的 app，将其添加至列表末尾以激活该应用：

INSTALLED_APPS = [ 
 'django.contrib.admin', 
 'django.contrib.auth', 
 'django.contrib.contenttypes', 
 'django.contrib.sessions', 
 'django.contrib.messages', 
 'django.contrib.staticfiles', 
 '你的app的名字', 
]

完成模型定义与激活后，需验证模型有效性。在早期 Django 版本中，可使用 python manage.py validate 命令进行检查：

若使用的 Django 版本较新（例如 1.10 及以上），执行上述命令可能会遇到错误提示：

Unknown command: ‘validate‘

Type ‘manage.py help‘ for usage.

针对新版本 Django，应使用 python manage.py check 命令进行验证：

验证通过后即可生成 SQL 语句。在此之前，你可能已在 model.py 中编写了相关模型代码，接下来需执行生成 SQL 的操作：

在旧版 Django 中，生成 SQL 的命令格式为 python manage.py sqlall ***（此处替换为你的 app 名称）：

若当前 Django 版本与命令不匹配，执行该命令时会收到错误提示：

Unknown command: ‘sqlall‘

Type ‘manage.py help‘ for usage.

同样地，若尝试通过 syncdb 命令将 SQL 提交至数据库，也会遇到如下错误提示：

Unknown command: ‘syncdb‘
Type ‘manage.py help‘ for usage.

目前较新版本的 Django 推荐使用的命令组合如下：

python manage.py makemigrations books #用来检测数据库变更和生成数据库迁移文件

python manage.py migrate #用来迁移数据库

python manage.py sqlmigrate books 0001 # 用来把数据库迁移文件转换成数据库语言

依次在命令行执行上述三个命令后，即可完成数据库迁移并开启数据访问：

以上即为 Django 根据配置生成 SQL 语句的完整指南，希望能为读者提供参考与支持。