Django 配置 MySQL 数据库完整指南

沿途有光
沿途有光
发布时间:2026-10-14| 4人浏览过
原创

本文详细介绍如何在 Django 项目中将默认 SQLite 切换为 MySQL 数据库。涵盖 mysqlclient 驱动安装、settings.py 中 DATABASES 参数配置(ENGINE、NAME、USER 等)、数据库创建命令,以及通过 makemigrations 和 migrate 完成模型到数据表的映射流程。

Django 配置 MySQL 数据库完整指南

Django 项目默认使用 sqlite 数据库,但是我想用mysql数据库,应该如何配置呢。

Django连接mysql数据库的操作,是通过根模块的配置实现的,在项目根模块的配置文件settings.py中,我们可以查询到如下DATABASES的配置信息:

理解 DATABASES 配置结构


DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.sqlite3',
    'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
  }
}

解释一下上面代码的意思:

ENGINE:用于特定的数据库引擎的配置,不同的数据库字段不同,常见的有:


django.db.backends.postgresql # PostgreSQL
django.db.backends.mysql    # mysql 
django.db.backends.sqlite3   # sqlite 
django.db.backends.oracle   # oracle

NAME: 是指要连接的数据库名字

django的文档中有说明,想使用mysql的话需要安装Python的db API DRIVER 即数据库接口驱动,常用的数据库驱动接口有三种,mysqldb、pymysql、mysqlclient 。但是但是MYSQLdb不支持python3 ,官方推荐使用mysqlclient。因此本文也是采用mysqlclient。好了废号不多说,开始今天的Django配置mysql之旅。

第一步:下载mysqlclient

安装 mysqlclient 驱动


pip install mysqlclient

第二步:创建一个数据库,比如我创建了一个blog数据库,你可以用命令创建,也可以用可视化工具(Navicat Premium)进行创建,命令创建数据库代码:

创建数据库与配置连接参数


CREATE DATABASE blog(database_name) CHARACTER SET UTF8; 
   #指定数据库的编码utf8

第三步:在settings.py中配置mysql连接参数,如下:


DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.mysql',
    'NAME': 'blog',
  'USER':'root',
  'PASSWORD':'kong1234,',
  'HOST':'127.0.0.1',
  'PORT':'3306',
  }
}
  • USER: 数据库登录的用户名,mysql一般都是root
  • PASSWORD:登录数据库的密码,必须是USER用户所对应的密码
  • HOST: 由于一般的数据库都是C/S结构的,所以得指定数据库服务器的位置,我们一般数据库服务器和客户端都是在一台主机上面,所以一般默认都填127.0.0.1
  • PORT:数据库服务器端口,mysql默认为3306
  • HOST和PORT都可以不填,使用默认的配置,但是如果你有更改默认配置的话,就需要填入更改后的

其实这样基本上完成了,为了更好地说明,举个实例进行演示一下数据的操作。

第四步:在你创建的应用中models.py创建model类。

比如我在我的blog应用下的,models.py中创建一个类,代码如下:

定义模型与执行迁移


from __future__ import unicode_literals
from django.db import models


class Article(models.Model):
  title = models.CharField(max_length=32, default='Title')
  content = models.TextField(null=True)

第五步:将字段映射成数据表,执行如下命令


python manage.py makemigrations (应用名,选写)
python manage.py migrate (应用名,选写)

第六步:执行python manage.py sqlmigrate应用名 文件id

查看sql语句


python manage.py sqlmigrate blog 0001 

具体django中数据库的操作可以参考下一篇博文。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。