尧图网站建设 
SQL调优组合拳Django-MySQL查询提示与pt-visual-explain执行计划可视化指南【免费下载链接】django-mysql:dolphin: :horse: Extensions to Django for use with MySQL/MariaDB项目地址: https://gitcode.com/gh_mirrors/dj/django-mysqlDjango-MySQL 是专为 Django MySQL/MariaDB 项目打造的扩展库它能帮你把 MySQL 特有的**查询提示Query Hints**注入 Django ORM 查询并用pt-visual-explain一键把执行计划画成树状图——定位慢查询、优化索引选择这套 SQL 调优组合拳新手也能轻松上手。1️⃣ 为什么需要查询提示MySQL 优化器很聪明但偶尔也会犯浑。官方文档里有个经典案例优化器有时会选择books - author的关联顺序导致查询变慢而你希望它按author - books来执行。在原生 Django ORM 里你无法直接往SELECT后面塞STRAIGHT_JOIN这样的关键字——手动拼 raw SQL 既繁琐又容易丢掉参数化安全。Django-MySQL 用了一个巧妙的思路解决这个问题在 SQL 中插入特殊注释/*QueryRewrite:...*/让它穿透Django 的 ORM 层再由一个包裹cursor.execute()的函数在真正执行前把注释重写成合法的 MySQL 提示语法。这个重写逻辑的核心实现就在 rewrite_query.py 的rewrite_query()函数中。2️⃣ 一行配置开启查询重写功能由于每条查询都有微小的重写开销这个功能默认是关闭的。在 Django 项目的settings.py中加一行即可激活DJANGO_MYSQL_REWRITE_QUERIES True3️⃣ 查询提示速查表常用方法一览激活后你的 QuerySet 就能调用下面这批魔法方法方法生成的 SQL 提示适用场景label(xxx)SELECT /*xxx*/ ...给查询打标在 slow_log 里一眼定位是哪段 Python 代码生成的慢查询straight_join()STRAIGHT_JOIN强制关联顺序拯救选错 join 顺序的查询sql_small_result()/sql_big_result()SQL_SMALL_RESULT/SQL_BIG_RESULT控制GROUP BY/DISTINCT是否使用临时表sql_buffer_result()SQL_BUFFER_RESULT高并发写入的表上缓冲结果尽早释放锁use_index()/force_index()/ignore_index()USE / FORCE / IGNORE INDEX引导或强制优化器选择指定索引可限定作用于JOIN、ORDER BY、GROUP BY阶段sql_calc_found_rows()SQL_CALC_FOUND_ROWS分页时顺带算出总行数免去再跑一次count()几个高频用法感受一下无需背语法照抄即可# 强制 author - books 的关联顺序 Author.objects.distinct().straight_join().filter(books__age12)[:10] # 限定索引只用于排序阶段 Author.objects.use_index(name_12345, for_ORDER BY).order_by(name) 小贴士索引名在数据库里通常是 Django 自动生成的带哈希后缀比如name_12345使用前先查一下表结构确认真实名字。4️⃣ pt-visual-explain把执行计划变成看得懂的树优化了提示之后怎么验证 MySQL真的改变了执行方式答案就是pt-visual-explain——Percona Toolkit 里把EXPLAIN输出格式化成可读树状图的工具。Django-MySQL 内置了pt_visual_explain()方法实现位于 query.py流程是捕获 QuerySet 对应的 SQL前置EXPLAIN关键字通过mysql客户端执行把结果管道给pt-visual-explain格式化输出。前提条件运行机器上装好 MySQL 客户端和 Percona Toolkit。然后直接 Author.objects.all().pt_visual_explain() Table scan rows 1020 - Table table myapp_author树状图里的rows预估扫描行数、key使用的索引就是调优时的核心关注点。 两个实用技巧传displayFalse可以把执行计划作为字符串返回方便调优前后保存对比如果你的模型没有加 QuerySetMixin也可以把它当独立函数用from django_mysql.models import pt_visual_explain pt_visual_explain(User.objects.all())5️⃣ 实战三步闭环从发现慢查询到确认生效看基线—— 对慢查询调用pt_visual_explain()记下当前的type、rows、key加提示—— 优先尝试use_index()/force_index()引导索引关联顺序不对则上straight_join()再对比—— 重新执行pt_visual_explain()确认rows显著下降、索引列变成预期值。三步闭环改完即验证告别玄学调优。6️⃣ FAQ这些坑帮你踩过了⚠️提示有微小开销每条查询都要过一遍重写逻辑所以DJANGO_MYSQL_REWRITE_QUERIES按需开启不必全局常开⚠️索引名不存在的硬错误给use_index()传入不存在的索引名MySQL 会直接报错——这意味着提示要跟着 schema 变更一起测试⚠️label 别传用户输入包含*/的注释会抛ValueError防止注入也请遵守这个约定⚠️注意版本差异查询缓存已被 MySQL 8.0 移除SQL_CALC_FOUND_ROWS在 8.0.17 已弃用老版本用法迁移前先确认自己的数据库版本。延伸阅读 QuerySet 扩展完整文档含全部提示方法与智能迭代docs/queryset_extensions.rst功能总览docs/exposition.rst查询重写核心实现src/django_mysql/rewrite_query.pypt-visual-explain 集成实现src/django_mysql/models/query.py【免费下载链接】django-mysql:dolphin: :horse: Extensions to Django for use with MySQL/MariaDB项目地址: https://gitcode.com/gh_mirrors/dj/django-mysql创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 SQL调优组合拳：Django-MySQL查询提示与pt-visual-explain执行计划可视化指南
SQL调优组合拳Django-MySQL查询提示与pt-visual-explain执行计划可视化指南【免费下载链接】django-mysql:dolphin: :horse: Extensions to Django for use with MySQL/MariaDB项目地址: https://gitcode.com/gh_mirrors/dj/django-mysqlDjango-MySQL 是专为 Django MySQL/MariaDB 项目打造的扩展库它能帮你把 MySQL 特有的**查询提示Query Hints**注入 Django ORM 查询并用pt-visual-explain一键把执行计划画成树状图——定位慢查询、优化索引选择这套 SQL 调优组合拳新手也能轻松上手。1️⃣ 为什么需要查询提示MySQL 优化器很聪明但偶尔也会犯浑。官方文档里有个经典案例优化器有时会选择books - author的关联顺序导致查询变慢而你希望它按author - books来执行。在原生 Django ORM 里你无法直接往SELECT后面塞STRAIGHT_JOIN这样的关键字——手动拼 raw SQL 既繁琐又容易丢掉参数化安全。Django-MySQL 用了一个巧妙的思路解决这个问题在 SQL 中插入特殊注释/*QueryRewrite:...*/让它穿透Django 的 ORM 层再由一个包裹cursor.execute()的函数在真正执行前把注释重写成合法的 MySQL 提示语法。这个重写逻辑的核心实现就在 rewrite_query.py 的rewrite_query()函数中。2️⃣ 一行配置开启查询重写功能由于每条查询都有微小的重写开销这个功能默认是关闭的。在 Django 项目的settings.py中加一行即可激活DJANGO_MYSQL_REWRITE_QUERIES True3️⃣ 查询提示速查表常用方法一览激活后你的 QuerySet 就能调用下面这批魔法方法方法生成的 SQL 提示适用场景label(xxx)SELECT /*xxx*/ ...给查询打标在 slow_log 里一眼定位是哪段 Python 代码生成的慢查询straight_join()STRAIGHT_JOIN强制关联顺序拯救选错 join 顺序的查询sql_small_result()/sql_big_result()SQL_SMALL_RESULT/SQL_BIG_RESULT控制GROUP BY/DISTINCT是否使用临时表sql_buffer_result()SQL_BUFFER_RESULT高并发写入的表上缓冲结果尽早释放锁use_index()/force_index()/ignore_index()USE / FORCE / IGNORE INDEX引导或强制优化器选择指定索引可限定作用于JOIN、ORDER BY、GROUP BY阶段sql_calc_found_rows()SQL_CALC_FOUND_ROWS分页时顺带算出总行数免去再跑一次count()几个高频用法感受一下无需背语法照抄即可# 强制 author - books 的关联顺序 Author.objects.distinct().straight_join().filter(books__age12)[:10] # 限定索引只用于排序阶段 Author.objects.use_index(name_12345, for_ORDER BY).order_by(name) 小贴士索引名在数据库里通常是 Django 自动生成的带哈希后缀比如name_12345使用前先查一下表结构确认真实名字。4️⃣ pt-visual-explain把执行计划变成看得懂的树优化了提示之后怎么验证 MySQL真的改变了执行方式答案就是pt-visual-explain——Percona Toolkit 里把EXPLAIN输出格式化成可读树状图的工具。Django-MySQL 内置了pt_visual_explain()方法实现位于 query.py流程是捕获 QuerySet 对应的 SQL前置EXPLAIN关键字通过mysql客户端执行把结果管道给pt-visual-explain格式化输出。前提条件运行机器上装好 MySQL 客户端和 Percona Toolkit。然后直接 Author.objects.all().pt_visual_explain() Table scan rows 1020 - Table table myapp_author树状图里的rows预估扫描行数、key使用的索引就是调优时的核心关注点。 两个实用技巧传displayFalse可以把执行计划作为字符串返回方便调优前后保存对比如果你的模型没有加 QuerySetMixin也可以把它当独立函数用from django_mysql.models import pt_visual_explain pt_visual_explain(User.objects.all())5️⃣ 实战三步闭环从发现慢查询到确认生效看基线—— 对慢查询调用pt_visual_explain()记下当前的type、rows、key加提示—— 优先尝试use_index()/force_index()引导索引关联顺序不对则上straight_join()再对比—— 重新执行pt_visual_explain()确认rows显著下降、索引列变成预期值。三步闭环改完即验证告别玄学调优。6️⃣ FAQ这些坑帮你踩过了⚠️提示有微小开销每条查询都要过一遍重写逻辑所以DJANGO_MYSQL_REWRITE_QUERIES按需开启不必全局常开⚠️索引名不存在的硬错误给use_index()传入不存在的索引名MySQL 会直接报错——这意味着提示要跟着 schema 变更一起测试⚠️label 别传用户输入包含*/的注释会抛ValueError防止注入也请遵守这个约定⚠️注意版本差异查询缓存已被 MySQL 8.0 移除SQL_CALC_FOUND_ROWS在 8.0.17 已弃用老版本用法迁移前先确认自己的数据库版本。延伸阅读 QuerySet 扩展完整文档含全部提示方法与智能迭代docs/queryset_extensions.rst功能总览docs/exposition.rst查询重写核心实现src/django_mysql/rewrite_query.pypt-visual-explain 集成实现src/django_mysql/models/query.py【免费下载链接】django-mysql:dolphin: :horse: Extensions to Django for use with MySQL/MariaDB项目地址: https://gitcode.com/gh_mirrors/dj/django-mysql创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考