↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / 系统目录

pg_stats

视图pg_stats提供对存储在pg_statistic目录中信息的访问。此视图仅允许访问用户具有读取权限的表对应的pg_statistic行,因此可以安全地允许对此视图进行公共读取访问。 pg_stats也旨在以比底层目录更易读的格式呈现信息— 但其模式必须在为pg_statistic定义新的槽类型时进行扩展。

英文手册覆盖始于 PostgreSQL 7.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

kind
view
lang
en
measured attributes
true
metadata release
18.6
runtime verified
false
source
english-manual

版本定义 PG 18

视图pg_stats提供对存储在pg_statistic目录中信息的访问。此视图仅允许访问用户具有读取权限的表对应的pg_statistic行,因此可以安全地允许对此视图进行公共读取访问。 pg_stats也旨在以比底层目录更易读的格式呈现信息— 但其模式必须在为pg_statistic定义新的槽类型时进行扩展。

目录列

列类型可空性描述
schemanamename可空包含表的模式名称
tablenamename可空表的名称
attnamename可空被此行描述的列名
inheritedbool可空如果为真,则此行包括来自子表的值,而不仅仅是指定表中的值
null_fracfloat4可空列项中为 NULL 的比例
avg_widthint4可空列的条目的平均字节宽度
n_distinctfloat4可空如果大于零,表示列中不同值的估计个数。如果小于零,是不同值个数除以行数的负值(当ANALYZE认为不同值的数量会随着表增长而增加时采用负值的形式,而如果认为列具有固定数量的可能值时采用正值的形式)。例如,-1表示一个唯一列,即其中不同值的个数等于行数。
most_common_valsanyarray可空列中高频值的一个列表(如果没有任何一个值看起来比其他值更常用,此列为 NULL)
most_common_freqsfloat4[]可空高频值的频率列表,即每一个高频值的出现次数除以总行数(如果most_common_vals为 NULL,则此列为 NULL)
histogram_boundsanyarray可空用于将列值划分为若干组的值列表,各组所含值的数量近似相等。如果存在most_common_vals,其中的值会被直方图计算所忽略(如果列类型没有一个<操作符或者most_common_vals列表覆盖了全部值,则此列为 NULL)
correlationfloat4可空物理行顺序和列值逻辑顺序之间的统计相关性。其范围从-1到+1。当值接近-1或+1时,在列上的一个索引扫描被估计为比值接近0时的代价更低,因为这种情况减少了对磁盘的随机访问(如果列数据类型不具有一个<操作符,则此列为 NULL)
most_common_elemsanyarray可空列值内最常出现的非 NULL 元素值的列表(对于标量类型为 NULL)。
most_common_elem_freqsfloat4[]可空高频元素值的频率列表,即至少包含一次给定值的行所占的比例。所有逐元素频率之后还有两个或三个附加值:前述逐元素频率的最小值和最大值,以及可选的 NULL 元素频率(当 most_common_elems 为 NULL 时,此列为 NULL)。
elem_count_histogramfloat4[]可空各列值中不同非 NULL 元素的数量的直方图,后面跟随该数量的平均值(对于标量类型为 NULL)。
range_length_histogramanyarray可空范围类型列中非空且非 NULL 的范围值长度直方图。(非范围类型为 null。) 该直方图使用范围函数 subtype_diff 计算,而不考虑范围边界是否包含端点。
range_empty_fracfloat4可空列项中值为空范围的比例。(非范围类型为 null。)
range_bounds_histogramanyarray可空非空且非 NULL 的范围值的下界和上界直方图(对于非范围类型为 NULL)。 这两个直方图表示为单个范围数组,其中各范围的下界表示下界直方图,上界表示上界直方图。

比较版本

完整来源事实

runtime columns

schemaname, tablename, attname, inherited, null_frac, avg_width, n_distinct, most_common_vals, most_common_freqs, histogram_bounds, correlation, most_common_elems, most_common_elem_freqs, elem_count_histogram, range_length_histogram, range_empty_frac, range_bounds_histogram

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · english-manuals:9e494107e6992dd2504e2967bba1837176eadd811fc8fd7b9df2d80efec96bbe

正文语言: zh-Hans · 2026-09-27@419045e