Django ORM 执行 SQL 语句的查看方法

Django ORM 日志监控配置

Django 的 ORM 系统对数据库交互提供了完善的封装，日常开发中绝大多数数据库操作均可通过 ORM 完成。然而，Django 将具体的查询过程隐藏在后端，这可能导致开发调试时不够直观。此外，若使用方式不当，还可能引发性能开销过大的问题。

那么，如何监控 Django 在何时执行了哪些 SQL 语句呢？解决方法是利用 Python 的 Logging 模块。

首先介绍具体配置方法。在 Django 项目的 settings.py 文件中添加 LOGGING 配置项，并将相关日志器的等级调整为 DEBUG 即可生效。

LOGGING = {
  'version': 1,
  'disable_existing_loggers': False,
  'formatters': {
    'simple': {
      'format': '[%(asctime)s] %(message)s'
    },
  },
  'handlers': {
    'console': {
      'level': 'DEBUG',
      'class': 'logging.StreamHandler',
      'formatter': 'simple'
    },
  },
  'loggers': {
    'django': {
      'handlers': ['console'],
      'level': 'DEBUG',
    },
  },
}

查看 SQL 执行日志

配置完成后，启动 runserver 服务，访问涉及数据库操作的页面，此时在运行服务的终端（shell）中即可看到相关的 SQL 执行日志，示例如下：

[2018-04-21 21:09:14,676] (0.002) SELECT `blog_article`.`id`, `blog_article`.`title`, `blog_article`.`cover`, `blog_article`.`content`, `blog_article`.`pub_date`, `blog_article`.`category_id`, `blog_article`.`views`, `blog_category`.`id`, `blog_category`.`name` FROM `blog_article` INNER JOIN `blog_category` ON (`blog_article`.`category_id` = `blog_category`.`id`) WHERE `blog_article`.`pub_date` < '2018-04-21 13:09:14.601856' ORDER BY `blog_article`.`pub_date` DESC LIMIT 10; args=('2018-04-21 13:09:14.601856',) [2018-04-21 21:09:14,678] (0.000) SELECT (`blog_article_topics`.`article_id`) AS `_prefetch_related_val_article_id`, `blog_topic`.`id`, `blog_topic`.`name`, `blog_topic`.`number` FROM `blog_topic` INNER JOIN `blog_article_topics` ON (`blog_topic`.`id` = `blog_article_topics`.`topic_id`) WHERE `blog_article_topics`.`article_id` IN (3, 4, 5, 6, 7, 8, 9, 10, 11, 12) ORDER BY `blog_topic`.`number` ASC; args=(3, 4, 5, 6, 7, 8, 9, 10, 11, 12) [2018-04-21 21:09:14,708] "GET / HTTP/1.1" 200 22325

上述日志展示了博客首页获取前 10 篇文章时执行的 SQL 语句片段。这些 SQL 对应的 Django ORM QuerySet 代码结构如下：

Article.objects.filter(pub_date__lt=timezone.now())[:10] \
.defer('author', 'category__number') \
.select_related('category') \
.prefetch_related('topics')

利用日志优化数据库查询

借助 Logging 功能，开发者不仅能查看生成的 SQL 语句，还能明确 Django 执行 SQL 的具体时机。在某些场景下，通过观察日志可以判断后台是否存在重复执行 SQL 的情况，从而为数据库访问优化提供依据。

Django 底层使用 Python 内建的 logging 模块来记录系统日志。

本文介绍了查看 Django ORM 执行 SQL 语句的方法，更多相关内容可参考本站其他文章或继续浏览后续内容，感谢支持。