★PostgreSQLカンファレンス2024 12月6日開催/チケット販売中★
他のバージョンの文書 16 | 15 | 14 | 13 | 12 | 11 | 10 | 9.6 | 9.5 | 9.4 | 9.3 | 9.2 | 9.1 | 9.0 | 8.4 | 8.3 | 8.2 | 8.1 | 8.0 | 7.4 | 7.3 | 7.2

45.57. pg_stats

pg_statsビューはpg_statisticカタログの情報にアクセスするためのビューです。 このビューは、ユーザが読み込み権限を持つテーブルに一致するpg_statisticの行に対してのみアクセスを許可しています。 よって、このビューに対して一般に読み込みを許可しても安全です。

pg_statsも、その基礎となっているカタログよりも、より読みやすい書式で情報を提供するように設計されています。 しかし、これは、もしpg_statisticに対して新しいスロット型が定義されるたびに、スキーマが拡張されなくてはならない、という犠牲を払っています。

表 45-58. pg_statsの列

名前参照先説明
schemanamenamepg_namespace.nspnameテーブルを持つスキーマ名
tablenamenamepg_class.relnameテーブル名
attnamenamepg_attribute.attnameこの行が記述する列名
inheritedbool 真の場合、この行には指定されたテーブルの値だけではなく、継承関係の子の列が含まれます。
null_fracreal NULLとなっている列項目の割合
avg_widthinteger 列項目のバイト単位による平均幅
n_distinctreal ゼロより大きい値は列内の個別値の推定数です。 ゼロより小さければ行数で個別値を割算した数字の負数です。 (テーブルが肥大するにつれ固有値の増大があり得るとANALYZEが判断した場合に負変換形式が使われます。 正変換形式は列の取り得る値が固定数を持つと思われる場合に使用されます)。 例えば-1は個別値の数が行数と等しいような、一意な列を表します。
most_common_valsanyarray 列の中の最も共通した値のリストです(他の値よりもより共通している値がない場合はNULLとなります)。 tsvectorといったいくつかのデータ型に対して、これは型そのものの値よりも、最も共通の要素の値の一覧です。
most_common_freqsreal[] 最も一般的な値、もしくは要素の出現頻度のリストで、つまり行の総数で出現数を割算した数字です(most_common_valsがNULLの時はNULLとなります)。 tsvectorのようないくつかのデータ型のために、most_common_vals配列より長いような追加情報を保存することができます。
histogram_boundsanyarray 列の値を満遍なく似たような数でグループに分配した値のリストです。 most_common_valsの値がもし存在すればこの度数分布計算は行われません (列データ型が<演算子を所有しない場合、もしくはmost_common_valsが全体の構成要素アカウントをリストしている場合、この列はNULLとなります)。
correlationreal 物理的な[訳注:ディスク上の]行の並び順と論理的な列の値の並び順に関する統計的相関です。 この値は-1から+1の範囲です。 値が-1もしくは+1の近辺にある時、ディスクにランダムアクセスする必要が少なくなるためこの列に対してのインデックススキャンは0近辺にある場合に比較して安価であると推定されます (列データ型に<演算子がない場合、この列はNULLとなります)。

most_common_valsおよびhistogram_bounds配列の最大項目数はALTER TABLE SET STATISTICSコマンドで列ごとに設定されるか、もしくはdefault_statistics_target実行時パラメータで包括的に設定されるかのいずれかです。