**摘要：**GaussDB(DWS)在SQL执行过程中，会记录表增删改查相关的运行时统计信息，并在事务提交或回滚后记录到共享的内存中。这些信息可以通过 “pg_stat_all_tables视图” 查询，也可以通过下面函数进行查询。

本文分享自华为云社区《一文读懂pgstat》，作者： leapdb 。

GaussDB(DWS)在SQL执行过程中，会记录表增删改查相关的运行时统计信息，并在事务提交或回滚后记录到共享的内存中。

这些信息可以通过 “pg_stat_all_tables视图” 查询，也可以通过下面函数进行查询。

pg_stat_get_tuples_inserted   --表累积insert条数
pg_stat_get_tuples_updated    --表累积update条数
pg_stat_get_tuples_deleted    --表累积delete条数
pg_stat_get_tuples_changed    --表自上次analyze以来，修改的条数
pg_stat_get_last_analyze_time --查询最近一次analyze时间

因此，根据共享内存中 "表自上次analyze以来修改过的条数" 是否超过一定阈值，就可以判定是否需要做analyze了。

1. 事务中如何记录统计信息

每个session有一个PgStat_TableStatus内存结构，当前事务访问过的每个表占用一个。

其中包含每一层子事务的统计信息，用结构体PgStat_TableXactStatus描述。这里记录了当前子事务增删改查的各种信息。

pg_stat_get_xact_numscans --当前事务在当前表上，启动顺序扫描的次数
pg_stat_get_xact_tuples_returned --当前事务在当前表上，顺序扫描抓取的可见元组条数。
pg_stat_get_xact_tuples_fetched --当前事务在当前表上，抓取的可见元组条数。
pg_stat_get_xact_tuples_inserted --当前事务在当前表上，插入条数
pg_stat_get_xact_tuples_deleted --当前事务在当前表上，删除条数
pg_stat_get_xact_tuples_updated --当前事务在当前表上，更新条数
pg_stat_get_xact_tuples_hot_updated --当前事务在当前表上，HOT更新条数
pg_stat_get_xact_blocks_fetched --当前事务在当前表上，选中的页面数
pg_stat_get_xact_blocks_hit --当前事务在当前表上，扫描过的页面数
pg_stat_get_xact_function_calls --当前事务在当前函数上，调用次数
pg_stat_get_xact_function_total_time --当前事务在当前函数上，所有调用的总执行时间
pg_stat_get_xact_function_self_time --当前事务在当前函数上，上次调用一次的执行时间
pg_stat_get_xact_partition_tuples_inserted --当前事务在当前表分区上，插入条数
pg_stat_get_xact_partition_tuples_deleted --当前事务在当前表分区上，删除条数
pg_stat_get_xact_partition_tuples_updated --当前事务在当前表分区上，更新条数
pg_stat_get_xact_partition_tuples_hot_updated --当前事务在当前表分区上，HOT更新条数

事务提交时会把当前表，所有子事务中的信息汇总，并转储到pgstat中。

2. 事务外如何记录统计信息

事务提交时将事务中的执行信息通过UDP报文发送给PgCollector后台线程，由其记录到统一的内存中，并在集群正常停止时转储到物理文件pg_stat_tmp/pgstat.stat中。

• 实例级信息，PgStat_GlobalStats
• 库级信息，PgStat_StatDBEntry
• 表级信息，其内存结构PgStat_StatTabEntry

--实例级信息
pg_stat_get_bgwriter_timed_checkpoints --后台写进程开启定时检查点的次数
pg_stat_get_bgwriter_requested_checkpoints --后台写进程开启基于后端请求的检查点的次数
pg_stat_get_checkpoint_write_time --最近一次checkpoint写页面的时间
pg_stat_get_checkpoint_sync_time --最近一次checkpoint同步页面的时间
pg_stat_get_bgwriter_buf_written_checkpoints --在检查点期间后台写进程写入的缓冲区数目。
pg_stat_get_bgwriter_buf_written_clean --为日常清理脏块，后台写进程写入的缓冲区数目。
pg_stat_get_bgwriter_maxwritten_clean --后台写进程停止清理扫描的时间，因为已经写入了更多的缓冲区（相比bgwriter_lru_maxpages参数声明的缓冲区数）。
pg_stat_get_buf_written_backend --后端进程写入的缓冲区数，因为它们需要分配一个新的缓冲区。
pg_stat_get_buf_fsync_backend --后台进程执行fsync的次数
pg_stat_get_buf_alloc --分配的总缓冲区数。
pg_stat_get_bgwriter_stat_reset_time --后台bgwriter线程的重置时间

--当前CN记录的库级信息
pg_stat_get_db_xact_commit --当前实例上指定数据库中已提交事务的数量。
pg_stat_get_db_xact_rollback --当前实例上指定数据库中回滚事务的数量。
pg_stat_get_db_blocks_fetched --当前实例上指定数据库中磁盘块抓取请求的数量。
pg_stat_get_db_blocks_hit --当前实例上指定数据库在缓冲区中找到的请求磁盘块的数量。
pg_stat_get_db_tuples_returned --当前实例上指定数据库返回的元祖数量。
pg_stat_get_db_tuples_fetched --当前实例上指定数据库中读取的元组数量。
pg_stat_get_db_tuples_inserted --当前实例上指定数据库中插入的元组数量。
pg_stat_get_db_tuples_updated --当前实例上指定数据库中更新的元组数量。
pg_stat_get_db_tuples_deleted --当前实例上指定数据库中删除的元组数量。
pg_stat_get_db_conflict_all --当前实例上指定数据库中发生冲突恢复的次数。
pg_stat_get_db_conflict_lock --集群中所有CN和DN上指定数据库锁冲突的总数。在DN上执行该函数，返回当前实例上指定数据库中锁冲突数量。
pg_stat_get_db_deadlocks --当前实例上指定数据库中死锁的数量。
pg_stat_get_db_temp_files --当前实例上指定数据库中创建临时文件的个数。
pg_stat_get_db_temp_bytes --当前实例上指定数据库中创建临时文件的字节数。
pg_stat_get_db_blk_read_time --当前实例上指定数据库中读数据块所用的时间。
pg_stat_get_db_blk_write_time --当前实例上指定数据库中写数据块所用的时间。

--整个集群记录的库级信息
pg_stat_get_db_total_xact_commit --在CN上执行该函数，返回集群中所有CN上指定数据库中已提交事务的总数。在DN上执行该函数，返回当前实例上指定数据库中已提交事务的数量。
pg_stat_get_db_total_xact_rollback --在CN上执行该函数，返回集群中所有CN上指定数据库中回滚事务的总数。在DN上执行该函数，返回当前实例上指定数据库中回滚事务的数量。
pg_stat_get_db_total_blocks_fetched --在CN上执行该函数，返回集群中所有DN上指定数据库中磁盘块抓取请求的总数。在DN上执行该函数，返回当前实例上指定数据库中磁盘块抓取请求的数量。
pg_stat_get_db_total_blocks_hit --在CN上执行该函数，返回集群中所有DN上指定数据库在缓冲区中找到的请求磁盘块的总数。在DN上执行该函数，返回当前实例上指定数据库在缓冲区中找到的请求磁盘块的数量。
pg_stat_get_db_total_tuples_returned --在CN上执行该函数，返回集群中所有DN上指定数据库返回的元组总数。在DN上执行该函数，返回当前实例上指定数据库返回的元组数量。
pg_stat_get_db_total_tuples_fetched --在CN上执行该函数，返回集群中所有DN上指定数据库读取的元组总数。在DN上执行该函数，返回当前实例上指定数据库读取的元组数量。
pg_stat_get_db_total_tuples_inserted --在CN上执行该函数，返回集群中所有DN上指定数据库插入的元组总数。在DN上执行该函数，返回当前实例上指定数据库插入的元组数量。
pg_stat_get_db_total_tuples_updated --在CN上执行该函数，返回集群中所有DN上指定数据库更新的元组总数。在DN上执行该函数，返回当前实例上指定数据库更新的元组数量。
pg_stat_get_db_total_tuples_deleted --在CN上执行该函数，返回集群中所有DN上指定数据库删除的元组总数。在DN上执行该函数，返回当前实例上指定数据库删除的元组数量。
pg_stat_get_db_total_conflict_all --在CN上执行该函数，返回集群中所有CN和DN上指定数据库发生冲突恢复的总次数。在DN上执行该函数，返回当前实例上指定数据库中发生冲突恢复的次数。
pg_stat_get_db_total_temp_files --在CN上执行该函数，返回集群中所有DN上指定数据库中创建临时文件的总个数。在DN上执行该函数，返回当前实例上指定数据库中创建临时文件的个数。
pg_stat_get_db_total_temp_bytes --在CN上执行该函数，返回集群中所有DN上指定数据库中创建临时文件的总字节数。在DN上执行该函数，返回当前实例上指定数据库中创建临时文件的字节数。
pg_stat_get_db_total_deadlocks --集群中所有CN和DN上指定数据库死锁的总数。在DN上执行该函数，返回当前实例上指定数据库中死锁的数量。
pg_stat_get_db_total_blk_read_time --在CN上执行该函数，返回集群中所有DN上指定数据库中读数据块所用的总时间。在DN上执行该函数，返回当前实例上指定数据库中读数据块所用的时间。
pg_stat_get_db_total_blk_write_time --在CN上执行该函数，返回集群中所有DN上指定数据库中写数据块所用的总时间。在DN上执行该函数，返回当前实例上指定数据库中写数据块所用的时间。

--表级信息
pg_stat_get_numscans --当前表上，启动顺序扫描的次数
pg_stat_get_tuples_returned --当前表上，顺序扫描抓取的可见元组条数。
pg_stat_get_tuples_fetched --当前表上，抓取的可见元组条数。
pg_stat_get_tuples_inserted --当前表上，插入条数
pg_stat_get_tuples_deleted --当前表上，删除条数
pg_stat_get_tuples_updated --当前表上，更新条数
pg_stat_get_tuples_hot_updated --当前表上，HOT更新条数
pg_stat_get_blocks_fetched --当前表上，选中的页面数
pg_stat_get_blocks_hit --当前表上，扫描过的页面数
pg_stat_get_function_calls --当前函数上，调用次数
pg_stat_get_function_total_time --当前函数上，所有调用的总执行时间
pg_stat_get_function_self_time --当前函数上，上次调用一次的执行时间
pg_stat_get_partition_tuples_inserted --当前表分区上，插入条数
pg_stat_get_partition_tuples_deleted --当前表分区上，删除条数
pg_stat_get_partition_tuples_updated --当前表分区上，更新条数
pg_stat_get_partition_tuples_hot_updated --当前表分区上，HOT更新条数
pg_stat_get_tuples_changed --当前表上自上一次analyze的历史累积变化量
pg_stat_get_partition_tuples_changed --当前表分区上自上一次analyze的历史累积变化量
pg_stat_get_partition_live_tuples --当前表分区上可见元组数
pg_stat_get_partition_dead_tuples --当前表分区上删除元组数
pg_stat_get_live_tuples --当前表上可见元组数
pg_stat_get_last_vacuum_time --当前表上最近一次vacuum的时间
pg_stat_get_last_data_changed_time --当前表上最近一次数据修改时间
pg_stat_get_last_autovacuum_time --当前表上最近一次autovacuum时间
pg_stat_get_last_autoanalyze_time --当前表上最近一次autoanalyze时间
pg_stat_get_last_analyze_time --当前表上最近一次手动analyze时间

--local表示当前节点的信息
pg_stat_get_local_tuples_updated
pg_stat_get_local_tuples_inserted
pg_stat_get_local_tuples_hot_updated
pg_stat_get_local_tuples_deleted
pg_stat_get_local_tuples_changed
pg_stat_get_local_live_tuples
pg_stat_get_local_last_autovacuum_time
pg_stat_get_local_last_autoanalyze_time
pg_stat_get_local_dead_tuples
pg_stat_get_local_autovacuum_count
pg_stat_get_local_autoanalyze_count
pg_stat_get_local_analyze_status

函数信息，PgStat_StatFuncEntry

pg_stat_get_function_calls --函数已被调用次数。
pg_stat_get_function_total_time --该函数花费的总挂钟时间，以微秒为单位。包括花费在此函数调用上的时间。
pg_stat_get_function_self_time --在当前事务中仅花费在此函数上的时间。不包括花费在调用函数上的时间。

3. 单节点的统计信息

每个CN和DN节点，各自记录自己的统计信息。可以通过上面的函数分别查看。

另外，CN在增删改的SQL执行结束时，将各个DN的返回条数信息记录到CN自己的pgstat结构中，构成了全局的统计信息。

4. 集群全局的统计信息

各个CN各自维护自己的pgstat信息，因此若想知道集群全局的，还需要向所有CN查询并汇总。

5. 统计信息的生命周期

pgstat中的统计信息属于运行时信息，这些信息处于事务外，不严格保证数据一致性。

在数据库异常停止时会清空所有数据，正常停止会保留数据。

6. 统计信息的维护

这些信息在执行SQL时被自动记录，不需要人工进行维护。

点击关注，第一时间了解华为云新鲜技术~