Python版的数据库查询构造器、ORM及动态迁移数据表。

Orator

Orator提供一个简单和方便的数据库数据处理库。
它的灵感来源于PHP的Laravel框架,借助其思想实现了python版的查询构造器和ORM。
这是完整的文档:http://orator-orm.com/docs

安装#

你可以有两种不同的安装方式。

  • 使用pip安装。
Copy
pip install orator

基本使用#

配置#

你需要开始配置数据库连接,及创建一个DatabaseManager实例。

Copy
from orator import DatabaseManager, Model config = { 'mysql': { 'driver': 'mysql', 'host': 'localhost', 'database': 'database', 'user': 'root', 'password': '', 'prefix': '' } } db = DatabaseManager(config) Model.set_connection_resolver(db)

定义一个模型#

Copy
class User(Model): pass

在模型中定义__table__属性来确定表名。

Copy
class User(Model): __table__ = 'my_users'

其次还可以定义__primary_key来确定主键,__connection__来确定连接。
如果你不希望默认创建updated_atcreated_at字段,则将__timestamps__属性置为False

查询模型所有数据#

Copy
users = User.all()

通过主键查询数据#

Copy
user = User.find(1) print(user.name)

使用模型查询#

Copy
users = User.where('votes', '>', 100).take(10).get() for user in users: print(user.name)

聚合查询#

你可以使用查询构造器。

Copy
count = User.where('votes', '>', 100).count()
Copy
users = User.where_raw('age > ? and votes = 100', [25]).get()

分片查询#

如果你希望一次查询一部分数据,则可以使用chunk方法。

Copy
for users in User.chunk(100): for user in users: # ...

指定数据库连接#

在模型中,可以使用on方法指定数据库连接。

Copy
user = User.on('connection-name').find(1)

你还可以使用read/write指定只读或只写连接。

Copy
user = User.on_write_connection().find(1)

字段管理#

当创建一个新的模型,通过构造函数给模型设置属性。
例如:在模型中设置__filltble或者__guarded__属性。

在模型中定义填充字段#

这个__filltable__属性。

Copy
class User(Model): __fillable__ = ['first_name', 'last_name', 'email']

在模型中定义禁止字段#

这个__guarded__属性。

Copy
class User(Model): __guarded__ = ['id', 'password']

禁止所有字段

Copy
__guarded__ = ['*']

插入、更新和删除#

保存一个新的模型#

在数据库中创建一个新的记录,使用save方法。

Copy
user = User() user.name = 'John' user.save()

在创建完成之后,可以这样获取到自增id。

Copy
inserted_id = user.id

使用create方法#

Copy
# Create a new user in the database user = User.create(name='John') # Retrieve the user by attributes, or create it if it does not exist user = User.first_or_create(name='John') # Retrieve the user by attributes, or instantiate it if it does not exist user = User.first_or_new(name='John')

更新数据#

Copy
user = User.find(1) user.name = 'Foo' user.save()

你也可以这样更新数据。

Copy
affected_rows = User.where('votes', '>', 100).update(status=2)

删除数据#

Copy
user = User.find(1) user.delete()

通过主键删除数据#

Copy
User.destroy(1) User.destroy(1, 2, 3)

你还可以这样删除数据。

Copy
affected_rows = User.where('votes', '>' 100).delete()

仅仅更新时间#

如果你想更新模型的时间,可以使用touch方法。

Copy
user.touch()

时间Timestamps#

在这个模型中created_atupdated_at是在数据库中默认生成的。如果,你不希望创建这两个字段,你可以设置属性__timestamps__false

Copy
class User(Model): __timestamps__ = False

提供自定义时间格式#

如果,你希望自己定义时间格式,你可以这样操作。

Copy
class User(Model): def get_date_format(): return 'DD-MM-YY'
posted @   Yxh_blogs  阅读(1019)  评论(0编辑  收藏  举报
编辑推荐:
· 智能桌面机器人:用.NET IoT库控制舵机并多方法播放表情
· Linux glibc自带哈希表的用例及性能测试
· 深入理解 Mybatis 分库分表执行原理
· 如何打造一个高并发系统?
· .NET Core GC压缩(compact_phase)底层原理浅谈
阅读排行:
· DeepSeek火爆全网,官网宕机?本地部署一个随便玩「LLM探索」
· 开发者新选择:用DeepSeek实现Cursor级智能编程的免费方案
· 【译】.NET 升级助手现在支持升级到集中式包管理
· 独立开发经验谈:如何通过 Docker 让潜在客户快速体验你的系统
· Tinyfox 发生重大改版
点击右上角即可分享
微信分享提示
CONTENTS