快捷導(dǎo)航

PostgreSQL 中 pg_stat_database 視圖的 tup_returned 字段的含義詳解

更新時(shí)間：2025年12月26日 10:27:58 作者：小精靈DBA

PostgreSQL的pg_stat_database視圖中的tup_returned字段統(tǒng)計(jì)了數(shù)據(jù)庫中所有查詢返回的行數(shù),是數(shù)據(jù)庫級(jí)別的累計(jì)值,它反映了數(shù)據(jù)庫的負(fù)載和查詢效率,本文介紹PostgreSQL中pg_stat_database視圖的tup_returned字段的含義,感興趣的朋友一起看看吧

核心定義

tup_returned 字面意思是 “返回的元組數(shù)”。

這里的“元組”可以通俗地理解為 數(shù)據(jù)表中的一行。

因此，tup_returned 統(tǒng)計(jì)的是 從數(shù)據(jù)庫中讀取到的行數(shù)。

詳細(xì)解釋

統(tǒng)計(jì)的是什么？
它統(tǒng)計(jì)的是由所有類型的查詢（SELECT, UPDATE, DELETE 等）所訪問到的行數(shù)。
例如：
- 一個(gè) SELECT * FROM table_name 查詢，返回了 100 行，那么這 100 就會(huì)被累加到 tup_returned 中。
- 一個(gè) UPDATE table_name SET column = value 語句，它需要先找到所有要更新的行（類似于一個(gè) SELECT），假設(shè)它匹配了 50 行，那么這 50 行也會(huì)被累加到 tup_returned 中，即使它最終更新了這些行（更新操作本身由 tup_updated 統(tǒng)計(jì)）。
- 同樣，DELETE 語句在刪除前也需要先找到這些行，所以找到的行數(shù)也會(huì)計(jì)入 tup_returned。
統(tǒng)計(jì)范圍：
- 這個(gè)統(tǒng)計(jì)是數(shù)據(jù)庫級(jí)別的。pg_stat_database 視圖中的這個(gè)值，是該 PostgreSQL 集群中單個(gè)數(shù)據(jù)庫的累計(jì)值。它包含了該數(shù)據(jù)庫內(nèi)所有表、所有查詢所返回的行數(shù)總和。
與 tup_fetched 的區(qū)別：
- 在 pg_stat_database 中，還有一個(gè)容易混淆的字段叫 tup_fetched。
- tup_returned：主要由順序掃描返回的行數(shù)。當(dāng)數(shù)據(jù)庫沒有使用索引，需要全表掃描來查找數(shù)據(jù)時(shí)，讀取的每一行都計(jì)入此項(xiàng)。
- tup_fetched：主要由索引掃描返回的行數(shù)。當(dāng)數(shù)據(jù)庫通過索引查找到數(shù)據(jù)行時(shí)，通過索引“獲取”到的每一行都計(jì)入此項(xiàng)。
簡(jiǎn)單總結(jié)：
- tup_returned ≈ 順序掃描讀到的行數(shù)
- tup_fetched ≈ 索引掃描讀到的行數(shù)

實(shí)踐意義與使用場(chǎng)景

tup_returned 是一個(gè)非常重要的宏觀性能指標(biāo)：

衡量數(shù)據(jù)庫負(fù)載： 這個(gè)值在持續(xù)、快速地增長，說明數(shù)據(jù)庫正在處理大量的數(shù)據(jù)讀取請(qǐng)求。通過觀察其增長速度，可以直觀了解數(shù)據(jù)庫的繁忙程度。
分析讀取模式： 結(jié)合 tup_returned 和 tup_fetched，可以判斷數(shù)據(jù)庫的查詢效率。
- 如果 tup_returned 的值遠(yuǎn)高于 tup_fetched，說明有大量的查詢正在進(jìn)行全表掃描，這可能意味著 缺少合適的索引。
- 一個(gè)健康的、以O(shè)LTP（在線事務(wù)處理）為主的數(shù)據(jù)庫，通常 tup_fetched 會(huì)遠(yuǎn)大于 tup_returned，因?yàn)榇蟛糠植樵兌紤?yīng)該通過索引來快速定位數(shù)據(jù)。
監(jiān)控長期趨勢(shì)： 通過定期記錄這個(gè)值，可以了解數(shù)據(jù)訪問量的變化趨勢(shì)，為容量規(guī)劃提供依據(jù)。

示例查詢

可以通過以下 SQL 語句查看所有數(shù)據(jù)庫的統(tǒng)計(jì)信息：

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

結(jié)果解讀：
假設(shè)看到某個(gè)數(shù)據(jù)庫的 tup_returned 是 10,000,000，而 tup_fetched 是 500,000。這強(qiáng)烈暗示該數(shù)據(jù)庫中存在效率低下的全表掃描查詢，應(yīng)該去檢查一下慢查詢?nèi)罩?，并為頻繁查詢的字段添加索引。

總結(jié)

特性	說明
中文名	返回的元組數(shù)
本質(zhì)	從數(shù)據(jù)庫中讀取到的行數(shù)（累計(jì)值）
主要來源	順序掃描（全表掃描）
對(duì)比指標(biāo)	`tup_fetched`（主要來自索引掃描）
主要用途	評(píng)估數(shù)據(jù)庫負(fù)載、分析查詢效率（判斷是否缺少索引）

簡(jiǎn)單來說，tup_returned 就是一個(gè)說明“數(shù)據(jù)庫自從啟動(dòng)以來，總共讀取了多少行數(shù)據(jù)”的計(jì)數(shù)器。它是一個(gè)非常重要的、用于宏觀性能分析和診斷的指標(biāo)。

到此這篇關(guān)于PostgreSQL 中 pg_stat_database 視圖的 tup_returned 字段的含義詳解的文章就介紹到這了,更多相關(guān)PostgreSQL pg_stat_database tup_returned 字段內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: