在使用SQLAlchemy的业务中设置的更新时间的server_default不生效时查找原因做了以下测试:
- default与server_default同时设置时,default优先级高于server_default。(参考图中time_both_default字段,该字段生效的是default的utc日期字段,即表中数据为8:07,而不是数据库中默认的本地时间即16:07)
- default走SQLAlchemy的Python程序,打印出SQL语句的话,相当于向数据库表中该字段插入了default设置的默认值;(参考图中所有设置了default值的字段:int_default、bool_default、time_default、time_both_default,最终入库值均为default的设置值,并且在insert的sql语句中均有体现)
- 而设置了server_default则走MySQL表结构中设置的DEFAULT值,打印SQL语句的话,相当于插入时没有插入该字段;(参考图中bool_server_default,值为0,对应insert的sql语句中没有该字段,time_server_default值为数据库默认的本地时间16:07)
- 而如果既不设置default也不设置server_default时,如果该字段不给定值,打印SQL语句的话,那么相当于默认该字段插入了None/Null值,数据库中设置的DEFAULT不生效;(参考图中time_not_default字段,SQL语句插入了None值,数据库DEFAULT默认本地时间失效,值为Null)
- 而如果sever_default默认值与数据库DEFAULT默认值不一致时,以数据库danDEFALUT值为准,参考第3条,因为此时没有插入该字段,即SQLAlchemy的server_default失效。(参考图中int_server_default,数据库中默认值为NULL,SQLAlchemy模型设置为9,结果为null)
一张图说明以上5点
测试用代码:
#!/usr/bin/env python3
# -*- coding=utf-8 -*-
"""
SQLAlchemy Column对象default与server_default区别。
"""
from datetime import datetime
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy import text, Column, Integer, String, Boolean, DateTime
from sqlalchemy.orm import sessionmaker
from sqlalchemy import create_engine
Base = declarative_base()
class ColumnDefaultTest(Base):
__tablename__ = 'column_default_test'
id = Column(Integer, primary_key=True, autoincrement=True)
name = Column(String(255), comment='名称')
int_default = Column(Integer, default=10, comment='SQLAlchemy默认')
int_server_default = Column(Integer, server_default=text("9"), comment='数据库默认')
bool_default = Column(Boolean, default=1, comment='SQLAlchemy默认')
bool_server_default = Column(Boolean, server_default=text("0"), comment='数据库默认')
time_default = Column(DateTime, default=datetime.utcnow, comment='SQLAlchemy默认')
time_not_default = Column(DateTime, comment='不设置默认值')
time_server_default = Column(DateTime, server_default=text('CURRENT_TIMESTAMP'), comment='SQLAlchemy默认')
time_both_default = Column(DateTime, default=datetime.utcnow, server_default=text('CURRENT_TIMESTAMP'), comment='同时默认')
# engine = create_engine('sqlite:///test_default.db', echo=True)
# Base.metadata.create_all(engine)
engine = create_engine('mysql+mysqldb://user:password@127.0.0.1:3306/data_base?charset=utf8mb4', echo=True)
session = sessionmaker(bind=engine)
db = session()
result = db.query(ColumnDefaultTest).all()
print(result)
insert_test = ColumnDefaultTest(name='默认值测试')
db.add(insert_test)
db.commit()
SQL建表语句:
CREATE TABLE `column_default_test` (
`id` int NOT NULL AUTO_INCREMENT COMMENT 'id',
`name` varchar(255) DEFAULT NULL COMMENT '名称',
`int_default` int DEFAULT NULL COMMENT 'SQLAlchemy默认',
`int_server_default` int DEFAULT NULL COMMENT '数据库默认',
`bool_default` tinyint DEFAULT NULL COMMENT 'SQLAlchemy默认',
`bool_server_default` tinyint DEFAULT 0 COMMENT '数据库默认',
`time_default` datetime DEFAULT NULL COMMENT 'SQLAlchemy默认',
`time_not_default` datetime DEFAULT CURRENT_TIMESTAMP COMMENT 'SQLAlchemy不设置默认值而数据库设置',
`time_server_default` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '数据库默认',
`time_both_default` datetime DEFAULT CURRENT_TIMESTAMP COMMENT 'SQLAlchemy与数据库同时设置默认',
PRIMARY KEY (`id`)
) ENGINE=InnoDB;