★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

51.11. pg_class

pg_classカタログはテーブルと、その他に列を持つもの、あるいはテーブルに似た全てのものを目録にしています。 その中にはインデックス(pg_indexも参照)、シーケンス(pg_sequenceも参照)、ビュー、マテリアライズドビュー、複合型およびTOASTテーブルが含まれます。 relkindを参照してください。 これより以降、リレーションと記されている場合はこれらすべてのオブジェクトを意味しています。 すべての列が全てのリレーションの型に該当するとは限りません。

表51.11 pg_classの列

名前参照先説明
oidoid 行識別子(隠し属性です。明示的に選択しなければなりません)
relnamename テーブル、インデックス、ビューなどの名前
relnamespaceoidpg_namespace.oid このリレーションを持つ名前空間のOID
reltypeoidpg_type.oidもし何らかの(pg_type項目を持たないインデックスではゼロ)が存在した場合このテーブルの行の型に対応するデータ型のOID
reloftypeoidpg_type.oid型付けされたテーブルでは背後にある複合型のOID。 その他のリレーションではゼロ。
relowneroidpg_authid.oidリレーションの所有者
relamoidpg_am.oidこれがインデックスの場合は、それに使われている(B-tree、ハッシュなどの)アクセスメソッド
relfilenodeoid このリレーションのディスク上のファイルの名前です。 ゼロはディスク上のファイル名が低レベルな状態で決定されるマップ付けされたリレーションであることを意味します。
reltablespaceoidpg_tablespace.oidこのリレーションが保存されているテーブル空間。 もしゼロならば、このデータベースのデフォルトテーブル空間を意味します。 (リレーションがディスク上のファイルになくても、問題はありません。)
relpagesint4 このテーブルのディスク上におけるページ単位(BLCKSZ)の表現サイズ。 これはプランナで使用される単なる推測値です。 VACUUMANALYZEおよびCREATE INDEXコマンドなどの一部のDDLコマンドで更新されます。
reltuplesfloat4 テーブル内の行数。 これはプランナで使用される単なる推測値です。 VACUUMANALYZECREATE INDEXなどの一部のDDLコマンドで更新されます。
relallvisibleint4 テーブル内の可視マップ内で全て可視とマークされているページ数。 これはプランナで使用される単なる見積です。 これはVACUUMANALYZEさらにCREATE INDEXといったいくつかのDDLコマンドで更新されます。
reltoastrelidoidpg_class.oidこのテーブルに関連しているTOASTテーブルのOID。 何もない場合はゼロです。 TOASTテーブルは行に収まらない大きい属性を副テーブルに格納します。
relhasindexbool テーブルであり、かつ、インデックスを持つ(あるいはつい最近まで持っていた)時は真。
relissharedbool クラスタ内の全てのデータベースにわたってこのテーブルが共有されている場合は真。 (pg_databaseのような)ある特定のシステムカタログのみ共有されます。
relpersistencechar pは永続テーブル、uはログを取らないテーブル、tは一時テーブルを表します。
relkindchar rは通常のテーブル、iはインデックス、Sはシーケンス、tはTOASTテーブル、vはビュー、mはマテリアライズドビュー、cは複合型、fは外部テーブル、pはパーティションテーブルを表します。
relnattsint2 リレーションにあるユーザ列数(システム列は含みません)。 pg_attributeにこれに対応する数多くの項目があるはずです。 pg_attribute.attnumも参照してください。
relchecksint2 テーブル上のCHECK制約の数。 pg_constraintカタログを参照してください。
relhasoidsbool リレーションの行毎にOIDを生成する場合は真。
relhaspkeybool テーブルに主キーが含まれている(あるいは過去含まれていた)場合に真。
relhasrulesbool もしテーブルにルールがある(あるいは以前あった)場合に真。 pg_rewriteカタログを参照してください。
relhastriggersbool もしテーブルにトリガがある(あるいは以前あった)場合に真。 pg_triggerカタログを参照してください。
relhassubclassbool もしテーブルが子テーブルに継承されている(または以前に継承されていた)場合は真。
relrowsecuritybool 行単位セキュリティが有効なテーブルでは真。 pg_policyカタログを参照。
relforcerowsecuritybool 行単位セキュリティが(有効にされているとして)テーブルの所有者にも適用されるなら真。 pg_policyカタログを参照。
relispopulatedbool リレーションにデータが投入されている場合に真(マテリアライズドビュー以外のすべてのリレーションでは真です。)
relreplidentchar  行にreplica identityフォームを使った列。 d デフォルト(もしあれば主キー)、 n 無し、 f 全ての列、 i インデックスと indisreplidentのセット、またはデフォルト
relispartitionbool テーブルがパーティションなら真
relfrozenxidxid この値より以前のトランザクションIDはすべて、このテーブルで永続的な(凍結された)トランザクションIDに置き換えられます。 これは、このテーブルに対して、トランザクションID周回を防ぎ、かつ、pg_xactを縮小させることを目的としたバキュームを行うかどうかを追跡するために使用されます。 リレーションがテーブルではない場合は0(InvalidTransactionId)です。
relminmxidxid このテーブル内のトランザクションIDによって置換される前のすべてのマルチトランザクションID。 これは、マルチトランザクションIDのID周回を防ぐ、またはpg_multixactを縮小させるために、テーブルをバキュームする必要があるかどうかを追跡するために使用されます。 リレーションがテーブルではない場合はゼロ(InvalidMultiXactId)です。
relaclaclitem[] アクセス権限。 詳細はGRANTREVOKEの説明を参照してください。
reloptionstext[] keyword=value文字列のような、アクセスメソッド特有のオプション。
relpartboundpg_node_tree テーブルがパーティションの場合(relispartition参照)のパーティション境界の内部表現。

pg_class内の複数の論理型フラグは、ゆっくりと保守されます。 正しい状態にあるときに真であることが保証されていますが、その条件が真でなくなった時即座に偽に再設定されないかもしれません。 例えばrelhasindexCREATE INDEXで設定されますが、DROP INDEXでは決して初期化されません。 代わりにVACUUMがそのテーブルにインデックスがないことを判定した場合にrelhasindexを初期化します。 この調整により競合状態を防止し、同時実行性が向上します。