PostgreSQL 中 pg_stat_database 视图的 tup_returned 字段的含义详解

 更新时间:2025年12月26日 10:27:58   作者:小精灵DBA  
PostgreSQL的pg_stat_database视图中的tup_returned字段统计了数据库中所有查询返回的行数,是数据库级别的累计值,它反映了数据库的负载和查询效率,本文介绍PostgreSQL中pg_stat_database视图的tup_returned字段的含义,感兴趣的朋友一起看看吧

此篇详细解释一下 PostgreSQL 中 pg_stat_database 视图里的 tup_returned 字段的含义。

核心定义

tup_returned 字面意思是 “返回的元组数”。

这里的“元组”可以通俗地理解为 数据表中的一行

因此,tup_returned 统计的是 从数据库中读取到的行数

详细解释

  • 统计的是什么?
  • 它统计的是由 所有类型的查询(SELECT, UPDATE, DELETE 等) 所访问到的行数。
  • 例如:
    • 一个 SELECT * FROM table_name 查询,返回了 100 行,那么这 100 就会被累加到 tup_returned 中。
    • 一个 UPDATE table_name SET column = value 语句,它需要先找到所有要更新的行(类似于一个 SELECT),假设它匹配了 50 行,那么这 50 行也会被累加到 tup_returned 中,即使它最终更新了这些行(更新操作本身由 tup_updated 统计)。
    • 同样,DELETE 语句在删除前也需要先找到这些行,所以找到的行数也会计入 tup_returned
  • 统计范围:
    • 这个统计是 数据库级别 的。pg_stat_database 视图中的这个值,是该 PostgreSQL 集群中 单个数据库 的累计值。它包含了该数据库内所有表、所有查询所返回的行数总和。
  • tup_fetched 的区别:
    • pg_stat_database 中,还有一个容易混淆的字段叫 tup_fetched
    • tup_returned: 主要由 顺序扫描 返回的行数。当数据库没有使用索引,需要全表扫描来查找数据时,读取的每一行都计入此项。
    • tup_fetched: 主要由 索引扫描 返回的行数。当数据库通过索引查找到数据行时,通过索引“获取”到的每一行都计入此项。
  • 简单总结:
    • tup_returned ≈ 顺序扫描读到的行数
    • tup_fetched ≈ 索引扫描读到的行数

实践意义与使用场景

tup_returned 是一个非常重要的宏观性能指标:

  • 衡量数据库负载: 这个值在持续、快速地增长,说明数据库正在处理大量的数据读取请求。通过观察其增长速度,可以直观了解数据库的繁忙程度。
  • 分析读取模式: 结合 tup_returnedtup_fetched,可以判断数据库的查询效率。
    • 如果 tup_returned 的值远高于 tup_fetched,说明有大量的查询正在进行全表扫描,这可能意味着 缺少合适的索引
    • 一个健康的、以OLTP(在线事务处理)为主的数据库,通常 tup_fetched 会远大于 tup_returned,因为大部分查询都应该通过索引来快速定位数据。
  • 监控长期趋势: 通过定期记录这个值,可以了解数据访问量的变化趋势,为容量规划提供依据。

示例查询

可以通过以下 SQL 语句查看所有数据库的统计信息:

SELECT 
    datname AS database_name,
    tup_returned,
    tup_fetched,
    tup_inserted,
    tup_updated,
    tup_deleted
FROM 
    pg_stat_database;

结果解读:
假设看到某个数据库的 tup_returned10,000,000,而 tup_fetched500,000。这强烈暗示该数据库中存在效率低下的全表扫描查询,应该去检查一下慢查询日志,并为频繁查询的字段添加索引。

总结

特性说明
中文名返回的元组数
本质从数据库中读取到的行数(累计值)
主要来源顺序扫描(全表扫描)
对比指标tup_fetched(主要来自索引扫描)
主要用途评估数据库负载、分析查询效率(判断是否缺少索引)

简单来说,tup_returned 就是一个说明“数据库自从启动以来,总共读取了多少行数据”的计数器。它是一个非常重要的、用于宏观性能分析和诊断的指标。

到此这篇关于PostgreSQL 中 pg_stat_database 视图的 tup_returned 字段的含义详解的文章就介绍到这了,更多相关PostgreSQL pg_stat_database tup_returned 字段内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 常用 PostgreSQL 数据恢复方案及使用示例

    常用 PostgreSQL 数据恢复方案及使用示例

    这篇文章主要介绍了常用 PostgreSQL 数据恢复方案概览,数据丢失通常是由 DDL 与 DML 两种操作引起,由于在操作系统中表文件已经不存在,所以只能采用恢复磁盘的方法进行数据恢复,需要的朋友可以参考下
    2022-01-01
  • PostgreSQL数据库授权与自增序列操作实例代码

    PostgreSQL数据库授权与自增序列操作实例代码

    在PostgreSQL中,自增序列是一种特殊的数据库对象,用于生成唯一的数字序列,通常用于主键值的自动生成,这篇文章主要介绍了PostgreSQL数据库授权与自增序列操作的相关资料,需要的朋友可以参考下
    2025-08-08
  • 解决postgresql 数字转换成字符串前面会多出一个空格的问题

    解决postgresql 数字转换成字符串前面会多出一个空格的问题

    这篇文章主要介绍了解决postgresql 数字转换成字符串前面会多出一个空格的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12
  • Postgresql根据响应数据反向实现建表语句与insert语句的过程

    Postgresql根据响应数据反向实现建表语句与insert语句的过程

    根据已有数据,可构建名为products的表,包含id(自增主键)、title(非空字符串)、progress(非空整数)三个字段,建表后,可通过insert语句插入数据,这种反向操作有助于从现有数据结构出发,快速构建数据库表,并进行数据填充,感兴趣的朋友跟随小编一起看看吧
    2022-02-02
  • 在PostgreSQL中优雅高效地进行全文检索的完整过程

    在PostgreSQL中优雅高效地进行全文检索的完整过程

    在现代应用中,用户期望通过自然语言快速找到所需内容,无论是电商商品搜索、文章检索还是日志分析,全文检索已成为核心功能,本文将从 基础原理、配置优化、高级技巧、性能调优、实战案例 五个维度,系统讲解如何在 PostgreSQL 中优雅高效地实现全文检索
    2026-01-01
  • PostgreSQL的应用技巧和示例分享

    PostgreSQL的应用技巧和示例分享

    本文会总结一些Postgres中,从应用需求和场景出发,不太常见,但比较常用并且有用的SQL语句,文中的示例代码简洁易懂,需要的小伙伴可以收藏一下
    2023-06-06
  • PostgreSQL表操作之表的创建及表基础语法总结

    PostgreSQL表操作之表的创建及表基础语法总结

    在PostgreSQL中创建表命令用于在任何给定的数据库中创建新表,下面这篇文章主要给大家介绍了关于PostgreSQL表操作之表的创建及表基础语法的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-05-05
  • Postgresql开启SQL执行语句收集过程

    Postgresql开启SQL执行语句收集过程

    本文介绍如何修改PostgreSQL的配置文件来启用SQL执行语句的日志记录,包括打开配置文件、修改日志相关设置以及查看日志文件的方法,关键步骤包括删除注释符号、设定日志存储路径和文件名、选择记录的SQL语句类型,此操作有助于数据库管理和问题调试
    2024-10-10
  • Linux下创建Postgresql数据库的方法步骤

    Linux下创建Postgresql数据库的方法步骤

    PostgreSQL 是一种非常复杂的对象-关系型数据库管理系统(ORDBMS),也是目前功能最强大,特性最丰富和最复杂的自由软件数据库系统。下面这篇文章主要给大家介绍了关于在Linux下创建Postgresql数据库的方法步骤,需要的朋友可以参考,下面来一起看看吧。
    2017-07-07
  • 关于PostgreSQL截取某个字段中的部分内容进行排序的问题

    关于PostgreSQL截取某个字段中的部分内容进行排序的问题

    这篇文章主要介绍了PostgreSQL截取某个字段中的部分内容进行排序,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-06-06

最新评论