2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 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 / 7.1

52.11. pg_class #

目录 pg_class 描述了具有列或与表类似的其它对象。这包括索引(但请参阅 pg_index)、序列(但请参阅 pg_sequence)、视图、物化视图、复合类型和 TOAST 表;请参阅 relkind。在下面的描述中,当我们指所有这些类型的对象时,我们称之为“关系”。并非 pg_class 的所有列对于所有关系类型都有意义。

表 52.11. pg_class

列 类型

描述

oid oid

行标识符

relname name

表、索引、视图等的名称。

relnamespace oid (引用 pg_namespace.oid)

包含此关系的名字空间的 OID。

reltype oid (引用 pg_type.oid)

如果存在,则此表行类型对应的数据类型的 OID;对于没有 pg_type 条目的索引、序列和 toast 表,此值为零。

reloftype oid (引用 pg_type.oid)

对于类型化表,底层复合类型的 OID;对于所有其他关系,此值为零。

relowner oid (引用 pg_authid.oid)

关系的属主。

relam oid (引用 pg_am.oid)

访问此表或索引所用的访问方法。如果关系是序列或没有磁盘文件,则此字段无意义;但对于分区表,如果设置了此字段,则在确定分区创建时使用的访问方法时,它会覆盖 default_table_access_method(当在创建命令中未指定时)。

relfilenode oid

此关系磁盘文件的名称;零表示这是一个“映射的”关系,其磁盘文件名由底层状态决定。

reltablespace oid (引用 pg_tablespace.oid)

存储此关系的表空间。如果为零,则表示使用数据库的默认表空间。如果关系没有磁盘文件,则此字段无意义;但对于分区表,这是创建分区时使用的表空间(当在创建命令中未指定时)。

relpages int4

此表磁盘表示的大小(以页为单位,每页大小为 BLCKSZ)。这只是规划器使用的估算值。它由 VACUUMANALYZE 和一些 DDL 命令(如 CREATE INDEX)更新。

reltuples float4

表中的活动行数。这只是规划器使用的估算值。它由 VACUUMANALYZE 和一些 DDL 命令(如 CREATE INDEX)更新。如果表从未被 vacuum 或 analyze 过,reltuples 包含 -1,表示行数未知。

relallvisible int4

表可见性映射中标记为“all-visible”(全部可见)的页数。这只是规划器使用的估算值。它由 VACUUMANALYZE 和一些 DDL 命令(如 CREATE INDEX)更新。

relallfrozen int4

表可见性映射中标记为“all-frozen”(全部冻结)的页数。这只是用于触发自动 vacuum 的估算值。它也可以与 relallvisible 一起用于安排手动 vacuum 和调整 vacuum 的冻结行为。它由 VACUUMANALYZE 和一些 DDL 命令(如 CREATE INDEX)更新。

reltoastrelid oid (引用 pg_class.oid)

与此表关联的 TOAST 表的 OID,如果没有则为零。TOAST 表将大的属性 离线 存储在辅助表中。

relhasindex bool

如果这是一个表并且它有(或最近有过)任何索引,则为真。

relisshared bool

如果此表在群集的所有数据库之间共享,则为真。只有某些系统目录(如 pg_database)是共享的。

relpersistence char

p = 永久表/序列,u = 未记录的表/序列,t = 临时表/序列。

relkind char

r = 普通表,i = 索引,S = 序列,t = TOAST 表,v = 视图,m = 物化视图,c = 复合类型,f = 外表,p = 分区表,I = 分区索引。

relnatts int2

关系中的用户列数(不包括系统列)。pg_attribute 中必须有对应数量的条目。另请参阅 pg_attribute.attnum

relchecks int2

表中 CHECK 约束的数量;请参阅 pg_constraint 目录。

relhasrules bool

如果表有(或曾经有)规则,则为真;请参阅 pg_rewrite 目录。

relhastriggers bool

如果表有(或曾经有)触发器,则为真;请参阅 pg_trigger 目录。

relhassubclass bool

如果表或索引有(或曾经有过)任何继承子项或分区,则为真。

relrowsecurity bool

如果启用了行级安全性,则为真;请参阅 pg_policy 目录。

relforcerowsecurity bool

如果行级安全性(启用时)也适用于表属主,则为真;请参阅 pg_policy 目录。

relispopulated bool

如果关系已填充,则为真(对于除某些物化视图之外的所有关系,此值都为真)。

relreplident char

用于为行形成“复制标识”的列:d = 默认(主键,如果有),n = 无,f = 所有列,i = 具有 indisreplident 设置的索引(如果使用的索引已被删除,则与无相同)。

relispartition bool

如果表或索引是分区,则为真。

relrewrite oid (引用 pg_class.oid)

对于在需要表重写(rewrite)的 DDL 操作期间写入的新关系,此字段包含原始关系的 OID;否则为零。该状态仅在内部可见;对于用户可见的关系,此字段永远不应包含除零以外的任何内容。

relfrozenxid xid

此表中的所有早于此事务 ID 的事务 ID 都已替换为永久(已冻结)事务 ID。这用于跟踪表是否需要 vacuum 以防止事务 ID 回绕或允许 pg_xact 被收缩。如果关系不是表,则此值为零(InvalidTransactionId)。

relminmxid xid

此表中的所有早于此多事务 ID 的多事务 ID 都已替换为事务 ID。这用于跟踪表是否需要 vacuum 以防止多事务 ID 回绕或允许 pg_multixact 被收缩。如果关系不是表,则此值为零(InvalidMultiXactId)。

relacl aclitem[]

访问权限;有关详细信息,请参阅 第 5.8 节

reloptions text[]

访问方法特定的选项,格式为“keyword=value”字符串。

relpartbound pg_node_tree

如果表是分区(请参阅 relispartition),则为分区边界的内部表示。


pg_class 中的几个布尔标志是惰性维护的:如果它们的状态正确,则保证为真,但当条件不再满足时,可能不会立即重置为假。例如,relhasindexCREATE INDEX 设置,但从不被 DROP INDEX 清除。相反,如果 VACUUM 发现表没有索引,它就会清除 relhasindex。这种安排可以避免竞态条件并提高并发性。

提交更正

如果您在文档中看到任何不正确、与您在使用特定功能时的经验不符或需要进一步澄清的内容,请使用 此表单 报告文档问题。