四 Django-模型和数据库基础

一、简介

Django 模型是与数据库相关的，与数据库相关的代码一般写在 models.py 中，Django 支持 sqlite3, MySQL, PostgreSQL,oracle等数据库，只需要在settings.py中配置即可，不用更改models.py中的代码，丰富的API极大的方便了使用。

二、模型

模型是你数据的唯一的、确定的信息源。 它包含你所储存数据的必要字段和行为。 通常，每个模型对应数据库中唯一的一张表

三、前期准备工作

1、django对支持MySQL有三个主要的驱动程序

• MySQLdb是Andy Dustman十多年来开发和支持的本地驱动程序,Django需要MySQLdb 1.2.3或更高版本。MySQLdb（1.2.5）的最新版本不支持Python 3,为了在Python 3下使用MySQLdb,需要安装mysqlclient
• mysqlclient是一个MySQLdb特别支持Python 3 的分支，可以用作MySQLdb的插入替代品
• MySQLconnector/ Python这个是纯python实现的MySQL接口，由Oracle维护(官方驱动)
• pymysql

所有这些驱动程序都是线程安全的，并提供连接池。MySQLdb是目前唯一不支持Python 3的。

除了DB API驱动程序之外，Django还需要一个适配器才能从ORM访问数据库驱动程序。Django为MySQLdb / mysqlclient提供了一个适配器，而MySQL Connector/Python包含它自己的。

2、下载驱动

sudo pip install pymysql

需要导入到django中，打开应用下/__init__.py文件

import pymysql

pymysql.install_as_MySQLdb() # 与mysql交互的函数

3、创建数据库

指定编码和排序规则

CREATE DATABASE IF NOT EXISTS **yourdbname **DEFAULT CHARSET utf8 COLLATE utf8_general_ci;

4、连接数据库

在settings.py中配置mysql连接参数（没有mysql的先装mysql）,连接方式有三种

1. NAME，USER，PASSWORD， HOST`，PORT
2. MySQL配置文件。
3. OPTIONS

1. 在settings.py中通用配置

   DATABASES = {
     'default': {
       'ENGINE': 'django.db.backends.mysql',
       'NAME': '数据库名',
       'USER':'mysql用户名（如root）',
       'PASSWORD':'密码（root）',
       'HOST':'域名（127.0.0.1或localhost）',
       'PORT':'端口号（3306）',
     }
   }
   

2. MySQL配置文件

   # settings.py
   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.mysql',
           #django.db.backends.postgresql  # PostgreSQL  
           #django.db.backends.sqlite3     # sqlite  
           #django.db.backends.oracle      # oracle 
           'OPTIONS': {
               'read_default_file': '配置文件路径/xxx.cnf',
           },
       }
   }
   #xxx.cnf
   [client]
   database = django
   user = root
   password = root
   host = 127.0.0.1
   port = 3306
   default-character-set = utf8
   

   #config.ini
   [global]
   ip = xxx
   port = xxx
   table = xxx
   uname = xxx
   passwd = xxx
   #读取本地配置文件用了个django自带的模块：configparser
   #在settings.py 中设置如下，按照相对路径取本地配置文件：
   import configparser
   import os
   dir_now = os.path.dirname(os.path.dirname(os.path.abspath("settings.py")))  # 路径自己指定，我这里是以settings.py为参考，abspath是取它的上级目录，也可以直接指定绝对路径来读取
   conf = configparser.ConfigParser()
   conf.read(dir_now+'/config.ini')  # 读config.ini文件
   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.mysql',  # 使用mysql这样写就行了，是指明引擎的
           'NAME': conf.get('global', 'table'),  # 库名
           'USER': conf.get('global', 'uname'),  # 用户名
           'PASSWORD': conf.get('global', 'passwd'),  # 密码
           'HOST': conf.get('global', 'ip'),  # 数据库主机ip
           'PORT': conf.get('global', 'port'),  # 数据库端口号
       }
   }
   

3. 其它

   # MySQL数据库配置项
   MYSQL_OPTIONS = {
       # 使用严格模式TRADITIONAL插入数据
       'sql_mode': 'TRADITIONAL',
       'charset': 'utf8',
       'init_command': """
      # 设置默认的数据库引擎   
       SET default_storage_engine=INNODB;
       # 设置连接的编码集 默认的排序方式
       SET character_set_connection=utf8,collation_connection=utf8_unicode_ci;
       # 设置数据库的事务级别
       SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED;
       """
   }
   DATABASES = {
       'default': {
        ...
      'OPTIONS': MYSQL_OPTIONS,
           # 设置数据库交互方式为事务
           'ATOMIC_REQUESTS': True,
          }
   ANSI模式：宽松模式，对插入数据进行校验，如果不符合定义类型或长度，对数据类型调整或截断保存，报warning警告。
   TRADITIONAL模式：严格模式，当向mysql数据库插入数据时，进行数据的严格校验，保证错误数据不能插入，报error错误。用于事物时，会进行事物的回滚。
   STRICT_TRANS_TABLES模式：严格模式，进行数据的严格校验，错误数据不能插入，报error错误      
   

四、数据迁移

1、编写models.py

1. 核心代码

   from django.db import models
   class Person(models.Model):
       SEX_CHOICES = (
           ('1', '男'),
           ('2', '女'),
       )
       pid = models.AutoField(primary_key=True)
       name = models.CharField(max_length=32)
       age = models.IntegerField()
       sex = models.CharField(max_length=2, choices=SEX_CHOICES)
       register_date = models.DateField(auto_now_add=True)
       class Mate:
           verbose_name = '人员信息'
           verbose_name_plural = verbose_name
       def __str__(self):
           return self.name
   

2. 注意事项
   models.py必须命名成models否则数据迁移时检测不到

2、数据库迁移

1. 说明
   这种方法可以在SQL等数据库中创建与models.py代码对应的表，不需要自己手动执行SQL。
   先 cd 进入 manage.py 所在的那个文件夹下，输入下面的命令
2. Django 1.6.x 及以下

   #1.7版本之前，Django只支持新增模型到数据库中；通过syncdb（migrate的前身）命令变更或者删除现存的模型市不可能的。 
   #第三方工具，尤其是South，支持这些增加的变更类型，但是现在被认为已经足够重要到需要引入到django的core中去
   python manage.py syncdb
   

3. Django 1.7 及以上的版本需要用以下命令

   #用来根据你对模型做的变更创建新的迁移脚本 
   python manage.py makemigrations  (可选,指定模块,默认整个项目下的app)
   #用来使迁移生效，以及未生效时报告它们的状态。
   python manage.py migrate  (可选,指定模块,默认整个项目下的app)
   

4. 执行migrate命令后相当于如下sql语句

   #默认表名(包名+类名)
   CREATE TABLE `test_person` (
     `pid` int(11) NOT NULL AUTO_INCREMENT,
     `name` varchar(32) NOT NULL,
     `age` int(11) NOT NULL,
     `sex` varchar(2) NOT NULL,
     `register_date` date NOT NULL,
      PRIMARY KEY (`pid`)
   )
   

3、通过表生成model

python manage.py inspectdb > app/models.py

五、其它数据库连接

1、oracle

1. Oracle数据库的服务名称进行连接,在setting文件中进行如下配置

   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.oracle',
           'NAME': '数据名',
           'USER': '用户名',
           'PASSWORD': '密码',
           'HOST': 'IP地址',
           'PORT': '端口',
       }
   }
   

2. Threaded选项
   如果您打算在多线程环境中运行Django（例如，在任何现代操作系统上使用默认MPM模块的Apache），则必须将threadedOracle数据库配置的选项设置为True：

   'OPTIONS': {
       'threaded': True,
   },
   

   但有可能导致一些意想不到的错误

2、配置控制台输出sql

1. 在settings.py文件中

   LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
    'console':{
     'level':'DEBUG',
     'class':'logging.StreamHandler',
    },
    },
    'loggers': {
    'django.db.backends': {
     'handlers': ['console'],
     'propagate': True,
     'level':'DEBUG',
    },
    }
   }