Django 执行原生 SQL 的三种方式与注意事项
本文详解 Django 中执行原生 SQL 的三种主要方式:使用 raw() 方法处理模型映射、利用 extra() 扩展查询条件以及通过 connection.cursor() 直接操作数据库游标。文章重点解析了参数传递的安全规范及百分号转义等关键细节,帮助开发者在保持 ORM 便利性的同时灵活处理复杂查询。
在 Django 中,有时需要绕过 ORM 直接使用原生 SQL 语句进行查询。其中一种常见方式是使用 方法,该方法允许在模型层面执行原生 SQL 并返回模型实例。通过这种方式,开发者可以将原生 SQL 的结果映射到现有的 Django 模型中,从而继续使用 ORM 提供的功能。需要注意的是,SELECT 语句中选取的字段必须与模型中的字段一一对应,否则可能导致数据映射错误。例如,可以通过 raw() 方法执行带有参数的查询,如根据 ID 范围筛选数据,并在结果集中遍历访问模型属性。
# row方法:(掺杂着原生sql和orm来执行的操作)
res = CookBook.objects.raw('select id as nid from epos_cookbook where id>%s', params=[1, ])
print(res.columns) # ['nid']
print(type(res)) # <class 'django.db.models.query.RawQuerySet'>
# 在select里面查询到的数据orm里面的要一一对应
res = CookBook.objects.raw("select * from epos_cookbook")
print(res)
for i in res:
print(i.create_date)
print(i)
res = CookBook.objects.raw('select * from epos_cookbook where id>%s', params=[1, ])
# 后面可以加参数进来
print(res)
for i in res:
# print(i.create_date)
print(i)
另一种执行原生 SQL 的方式是使用 方法,它允许在现有的 QuerySet 基础上添加额外的 SQL 片段。这种方法适用于需要简单扩展查询逻辑的场景,例如在 SELECT 子句中增加计算字段、在 WHERE 子句中指定复杂的查询条件,或者在 FROM 子句中连接其他表。在使用 extra() 时,务必注意参数传递的安全性。错误的做法是将变量直接拼接到 SQL 字符串中,这可能导致 SQL 注入漏洞;正确的做法是使用 params 参数传递变量,由 Django 自动处理转义和类型转换,确保查询安全。
## select提供简单数据
# SELECT age, (age > 18) as is_adult FROM myapp_person;
Person.objects.all().extra(select={'is_adult': "age > 18"}) # 加在select后面
## where提供查询条件
# SELECT * FROM myapp_person WHERE first||last ILIKE 'jeffrey%';
Person.objects.all().extra(where=["first||last ILIKE 'jeffrey%'"]) # 加一个where条件
## table连接其它表
# SELECT * FROM myapp_book, myapp_person WHERE last = author_last
Book.objects.all().extra(table=['myapp_person'], where=['last = author_last']) # 加from后面
## params添参数
# !! 错误的方式 !!
first_name = 'Joe' # 如果first_name中有SQL特定字符就会出现漏洞
Person.objects.all().extra(where=["first = '%s'" % first_name])
# 正确方式
Person.objects.all().extra(where=["first = '%s'"], params=[first_name])
对于更底层的数据库操作,Django 提供了 模块,允许开发者直接获取数据库连接并创建游标对象。通过调用 connection.cursor() 可以获取当前默认数据库的游标,若需操作其他数据库,可通过 connection['数据库别名'].cursor() 指定。获取游标后,使用 execute() 方法执行 SQL 语句,并通过 fetchall() 等方法获取查询结果。这种方式返回的是原始数据元组,不涉及模型映射,适用于不需要 ORM 功能的简单查询或批量操作场景。
from django.db import connection
cursor=connection.cursor()
# 如果需要配置数据库
# cursor=connection['default'].cursor()
cursor.execute('select * from app01_book')
ret=cursor.fetchall()
print(ret)
#((2, '小时光', Decimal('10.00'), 2), (3, '未来可期', Decimal('33.00'), 1), (4, '打破思维里的墙', Decimal('11.00'), 2), (5, '时光不散', Decimal('11.00'), 3))
在使用原生 SQL 时,有一个关键细节需要注意:如果 SQL 语句中包含除法符号(%),必须使用 %% 进行转义。这是因为在 Python 字符串中,% 符号通常用于格式化输出,若不进行转义,可能会导致字符串格式化错误。因此,在构建包含百分号的 SQL 语句时,务必使用双百分号 %% 来确保语句正确执行。
本文介绍了 Django 中使用原生 SQL 的几种常用方法及其注意事项。通过合理运用 raw()、extra() 和 connection 模块,开发者可以在保持 ORM 优势的同时,灵活处理复杂的数据库查询需求。希望本文能帮助您更好地掌握 Django 中的原生 SQL 操作技巧,如有更多相关问题,欢迎参考本站其他文章或继续浏览后续内容。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













