在Django中如何执行原生SQL查询详解

 更新时间:2025年10月21日 10:02:18   作者:唐古乌梁海  
Django框架作为Python中一个强大的Web开发框架,提供了丰富的ORM功能,使得开发者能够通过Python对象来操作数据库,这篇文章主要介绍了在Django中如何执行原生SQL查询的相关资料,需要的朋友可以参考下

在Django中,执行原生SQL查询

1. 使用raw()方法

raw() 方法允许你执行原生SQL查询并返回模型实例:

from myapp.models import Person

# 基本查询
people = Person.objects.raw('SELECT * FROM myapp_person WHERE age > %s', [18])

# 遍历结果
for person in people:
    print(person.name, person.age)

# 带参数的查询
people = Person.objects.raw(
    'SELECT * FROM myapp_person WHERE age BETWEEN %s AND %s',
    [20, 30]
)

2. 使用数据库连接直接执行SQL

基本用法:

from django.db import connection

def my_custom_sql():
    with connection.cursor() as cursor:
        # 执行查询
        cursor.execute("SELECT * FROM myapp_person WHERE age > %s", [25])
        
        # 获取所有结果
        rows = cursor.fetchall()
        
        # 或者逐行获取
        # row = cursor.fetchone()
        # rows = cursor.fetchmany(size=10)
    
    return rows

返回字典格式的结果:

from django.db import connection

def dictfetchall(cursor):
    """将游标结果转换为字典列表"""
    columns = [col[0] for col in cursor.description]
    return [
        dict(zip(columns, row))
        for row in cursor.fetchall()
    ]

def my_custom_sql():
    with connection.cursor() as cursor:
        cursor.execute("SELECT id, name, age FROM myapp_person")
        results = dictfetchall(cursor)
    return results

3. 使用多个数据库

如果你的项目配置了多个数据库:

from django.db import connections

def query_multiple_dbs():
    # 使用默认数据库
    with connections['default'].cursor() as cursor:
        cursor.execute("SELECT * FROM table1")
        # 处理结果
    
    # 使用其他数据库
    with connections['other_db'].cursor() as cursor:
        cursor.execute("SELECT * FROM table2")
        # 处理结果

4. 执行写操作(INSERT/UPDATE/DELETE)

from django.db import connection

def update_data():
    with connection.cursor() as cursor:
        # INSERT
        cursor.execute(
            "INSERT INTO myapp_person (name, age) VALUES (%s, %s)",
            ['John', 30]
        )
        
        # UPDATE
        cursor.execute(
            "UPDATE myapp_person SET age = %s WHERE name = %s",
            [31, 'John']
        )
        
        # DELETE
        cursor.execute(
            "DELETE FROM myapp_person WHERE age < %s",
            [18]
        )

5. 事务处理

from django.db import transaction, connection

@transaction.atomic
def complex_operation():
    with connection.cursor() as cursor:
        try:
            # 一系列SQL操作
            cursor.execute("UPDATE accounts SET balance = balance - %s", [100])
            cursor.execute("UPDATE accounts SET balance = balance + %s", [100])
        except Exception as e:
            # 出错时会自动回滚
            print(f"Error: {e}")

6. 实用的封装函数

from django.db import connection

def execute_query(query, params=None, return_dict=True):
    """
    执行SQL查询的通用函数
    """
    with connection.cursor() as cursor:
        cursor.execute(query, params or [])
        
        if query.strip().upper().startswith('SELECT'):
            if return_dict:
                columns = [col[0] for col in cursor.description]
                return [dict(zip(columns, row)) for row in cursor.fetchall()]
            else:
                return cursor.fetchall()
        else:
            # 对于非SELECT查询,返回受影响的行数
            return cursor.rowcount

# 使用示例
results = execute_query(
    "SELECT name, age FROM myapp_person WHERE age > %s",
    [25]
)

注意事项

  1. SQL注入防护:始终使用参数化查询,不要直接拼接字符串

    # ✅ 安全:使用参数化查询
    cursor.execute("SELECT * FROM users WHERE username = %s", [username])
    
    # ❌ 危险:字符串拼接(SQL注入风险)
    cursor.execute(f"SELECT * FROM users WHERE username = '{username}'")
    
    # ❌ 危险:直接传递用户输入
    cursor.execute("SELECT * FROM users WHERE username = %s" % username)
    
  2. 表名引用:在SQL中使用实际的数据库表名,而不是模型名

  3. 性能考虑:原生SQL通常更快,但失去了Django ORM的一些便利功能;使用直接连接:需要最高性能、复杂查询或跨表查询

  4. 数据库兼容性:如果你使用多个数据库后端,要注意SQL语法的差异

这些方法让你在需要优化性能或执行复杂查询时,能够灵活地使用原生SQL,同时保持代码的安全性和可维护性。

总结

到此这篇关于在Django中如何执行原生SQL查询的文章就介绍到这了,更多相关Django执行原生SQL查询内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 查看Python安装路径几种方法

    查看Python安装路径几种方法

    在使用python的时候,有时候会需要找到python包的安装位置,本文主要介绍了查看Python安装路径几种方法,具有一定的参考价值,感兴趣的可以了解一下
    2023-09-09
  • python中sort()和sorted()的区别及用法实例

    python中sort()和sorted()的区别及用法实例

    我们通常会遇到对数据库中的数据进行排序的问题,下面这篇文章主要给大家介绍了关于python中sort()和sorted()的区别及用法的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-06-06
  • 一文讲解Python和PyTorch的核心区别(零基础秒懂)

    一文讲解Python和PyTorch的核心区别(零基础秒懂)

    PyTorch最近几年可谓大火,相比于TensorFlow,PyTorch对于Python初学者更为友好,更易上手,下面这篇文章主要介绍了Python和PyTorch核心区别的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2026-01-01
  • Pycharm同步远程服务器调试的方法步骤

    Pycharm同步远程服务器调试的方法步骤

    这篇文章主要介绍了Pycharm同步远程服务器调试,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-11-11
  • 在python下使用tensorflow判断是否存在文件夹的实例

    在python下使用tensorflow判断是否存在文件夹的实例

    今天小编就为大家分享一篇在python下使用tensorflow判断是否存在文件夹的实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-06-06
  • Python使用pdfminer.six实现精准控制PDF文本布局

    Python使用pdfminer.six实现精准控制PDF文本布局

    pdfminer.six是一款强大的Python库,专注于PDF文档的精细解析,提供字符级定位和布局控制能力,下面小编就和大家详细介绍一下它的具体用法吧
    2026-04-04
  • Python优化算法之遗传算法案例代码

    Python优化算法之遗传算法案例代码

    优化算法,尤其是启发式的仿生智能算法在最近很火,它适用于解决管理学,运筹学,统计学里面的一些优化问题,这篇文章主要介绍了Python优化算法—遗传算法,需要的朋友可以参考下
    2023-02-02
  • python如何通过正则匹配指定字符开头与结束提取中间内容

    python如何通过正则匹配指定字符开头与结束提取中间内容

    这篇文章主要介绍了python通过正则匹配指定字符开头与结束提取中间内容的操作方法,本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-02-02
  • python实现类的静态变量用法实例

    python实现类的静态变量用法实例

    这篇文章主要介绍了python实现类的静态变量用法,实例分析了Python中基于数组实现静态队列的相关使用技巧,需要的朋友可以参考下
    2015-05-05
  • Python使用Scrapy抓取和解析网页数据的方法

    Python使用Scrapy抓取和解析网页数据的方法

    很多 Python 初学者学完基础语法后,都会遇到一个很实际的问题:怎么把网页里的数据稳定地提取下来,变成自己能处理的结构化数据,Scrapy 是 Python 生态里非常经典的爬虫框架,本文给大家介绍了Python使用Scrapy抓取和解析网页数据的方法,需要的朋友可以参考下
    2026-05-05

最新评论