常见数据类型与Column参数
常见类型
- Integer:整数类型,对应数据库的
int
类型。 - Float:浮点数类型,对应数据库的
float
类型。它占用32
位空间。 - Double:双精度浮点数类型,对应数据库的
double
类型,占用64
位空间。需要注意的是在 SQLAlchemy 中没有Double
类型。 - String:可变字符类型,对应数据库的
varchar
类型。 - Boolean:布尔类型,对应数据库的
tinyint
类型。 - DECIMAL:定点数类型,主要用于解决浮点数精度问题。在存储与金钱相关的字段时,推荐使用此数据类型。使用时需要传递两个参数,第一个参数表示字段能存储的总位数,第二个参数表示小数点后的位数。
- Enum:枚举类型,限制字段值只能为预设的几个值。在 ORM 模型中,使用
Enum
类型表示枚举。也可以用 Python3 内置的enum
模块定义字段。 - Date:日期类型,只能存储年月日。对应数据库的
date
类型。在 Python 代码中,可以使用datetime.date
来指定。 - DateTime:日期时间类型,可以存储年月日时分秒毫秒等。对应数据库的
datetime
类型。在 Python 代码中,可以使用datetime.datetime
来指定。 - Time:时间类型,可以存储时分秒。对应数据库的
time
类型。在 Python 代码中,可以使用datetime.time
来指定。 - Text:长字符串类型,一般可以存储超过 6 万个字符。如果超出这个范围,可以使用
LONGTEXT
类型。对应数据库的text
类型。 - LONGTEXT:超长文本类型,对应数据库的
longtext
类型。
常见的 Column 参数
- primary_key:将此字段设置为主键,需要设定值为
True
。 - autoincrement:将此字段设置为自动递增,需设定值为
True
。 - default:为某个字段设置默认值,常用于如发布时间等字段。
- nullable:确定某个字段是否可以为空。默认值为
True
,意味着该字段可以为空。 - unique:确定某个字段的值是否需唯一。默认值为
False
。 - onupdate:在更新数据时会调用这个参数指定的值或函数。初次插入数据时,不会使用
onupdate
的值,而是使用default
的值。这个参数常用于update_time
字段(每次数据更新时都需更新该字段的值)。 - name:指定 ORM 模型中的某个属性映射到表中的字段名。如果未指定,则会使用该属性的名称作为字段名。如果已指定,则会使用指定的值作为表字段名。该参数也可以作为位置参数,在第一个参数中指定,如:
title = Column(String(50),name='title',nullable=False)
或者
title = Column('my_title',String(50),nullable=False)
。
样例实现
class News(Base):__tablename__ = 'news'# id 整数类型,限制主键自增id = Column(Integer, primary_key=True, autoincrement=True)# 标题 长度为 100 字符类型, 不能为空title = Column(String(100), nullable=False)# 作者电话 字符类型 唯一author_telephone = Column(String(11), unique=True, nullable=False)# 是否删除 整型,不能为空, 默认为 0is_delete = Column(Integer, nullable=False, default=0)# 是否公开 布尔类型, 不能为空, 默认为 Trueis_published = Column(Boolean, nullable=False, default=True)# 标题1 枚举类型 常规写法tag1 = Column(Enum('python', 'java', 'go', 'javascript'))# 标题2 枚举类型 另一种写法tag2 = Column(Enum(TagEnum))# 时间的三种类型created_at = Column(Date, default=datetime.datetime.now)updated_at = Column(DateTime, onupdate=datetime.datetime.now, default=datetime.datetime.now)published_at = Column(Time)# 文本的两种类型content1 = Column(Text)content2 = Column(LONGTEXT)
生成的数据库表字段如下:
生成的 SQL 语句如下:
create table news
(id int auto_incrementprimary key,title varchar(100) not null,author_telephone varchar(11) not null,is_delete int not null,is_published tinyint(1) not null,tag1 enum ('python', 'java', 'go', 'javascript') null,tag2 enum ('python', 'java', 'c', 'javascript', 'cpp') null,created_at date null,updated_at datetime null,published_at time null,content1 text null,content2 longtext null,constraint author_telephoneunique (author_telephone)
);
测试样例
新增一条数据,并更新相关字段值。
# 新建一个会话对象
session = sessionmaker(bind=engine)()# 创建一个 new 对象
new_demo = News(title='测试new',author_telephone='15991367893',is_delete=0,is_published=True,tag1='go',tag2=TagEnum.c,created_at=datetime.datetime.now(),updated_at=datetime.datetime.now(),published_at=datetime.time(),content1='这是一个测试性内容1',content2='这是一个测试性内容2')# session.add(new_demo)
# session.commit()
# session.close()# 测试 onupdate 参数
a_new = session.query(News).first()
a_new.title = '这是修改后的标题'
a_new.author_telephone = '15991367894'
# 提交事物
session.commit()
session.close()
注意
我们设置了author_telephone
此处有些不足,不能满足正常开发需求,切忌在项目中使用。