PostgreSQL 13.1 中文入门教程 PostgreSQL pg_class

2024-02-25 开发教程 PostgreSQL 13.1 中文入门教程匿名 0℃

目录pg_class记录表和几乎所有具有列或者像表的东西。这包括索引（但还要参见pg_index）、序列（但还要参见pg_sequence）、视图、物化视图、组合类型和TOAST表，参见relkind。下面，当我们提及所有这些类型的对象时我们使用 “关系”。并非所有列对于所有关系类型都有意义。

表 51.11. pg_classColumns

列类型描述
`oidoid` 行标识符
`relnamename` 表、索引、视图等的名字
`relnamespaceoid`(references `pg_namespace`.`oid`) 包含该关系的名字空间的OID
`reltypeoid`(references `pg_type`.`oid`) 可能存在的表行类型所对应数据类型的OID（对索引为0，索引没有`pg_type`项）
`reloftypeoid`(references `pg_type`.`oid`) 对于有类型的表，为底层组合类型的OID，对于其他所有关系为0
`relowneroid`(references `pg_authid`.`oid`) 关系的拥有者
`relamoid`(references `pg_am`.`oid`) 如果这是一个表或者索引，表示索引使用的访问方法（堆、B树、哈希等）
`relfilenodeoid` 该关系的磁盘文件的名字，0表示这是一个“映射”关系，其磁盘文件名取决于低层状态
`reltablespaceoid`(references `pg_tablespace`.`oid`) 该关系所存储的表空间。如果为0，使用数据库的默认表空间。（如果关系无磁盘文件时无意义）
`relpagesint4` 该表磁盘表示的尺寸，以页面计（页面尺寸为`BLCKSZ`）。这只是一个由规划器使用的估计值。它被`VACUUM`、`ANALYZE`以及一些DDL命令（如`CREATE INDEX`）所更新。
`reltuplesfloat4` 表中的存活行数。这只是一个由规划器使用的估计值。它被`VACUUM`、`ANALYZE`以及一些DDL命令（如`CREATE INDEX`）所更新。
`relallvisibleint4` 在表的可见性映射表中被标记为全可见的页数。这只是一个由规划器使用的估计值。它被`VACUUM`、`ANALYZE`以及一些DDL命令（如`CREATE INDEX`）所更新。
`reltoastrelidoid`(references `pg_class`.`oid`) 与该表相关联的TOAST表的OID，如果没有则为0。TOAST表将大属性“线外”存储在一个二级表中。
`relhasindexbool` 如果这是一个表并且其上建有（或最近建有）索引则为真
`relissharedbool` 如果该表在集簇中的所有数据库间共享则为真。只有某些系统目录（如`pg_database`）是共享的。
`relpersistencechar` `p`= 永久表，`u`= 无日志表， `t`= 临时表
`relkindchar` `r`= 普通表， `i`= 索引， `S`= 序列， `t`= TOAST表， `v`= 视图， `m`= 物化视图， `c`= 组合类型， `f`= 外部表， `p`= 分区表， `I`= 分区索引
`relnattsint2` 关系中用户列的数目（系统列不计算在内）。在`pg_attribute`中必须有这么多对应的项。另请参阅`pg_attribute.attnum`。
`relchecksint2` 表上`CHECK`约束的数目，参见`pg_constraint`目录
`relhasrulesbool` 如果表有（或曾有）规则则为真，参见`pg_rewrite`目录
`relhastriggersbool` 如果表有（或曾有）触发器则为真，参见 `pg_trigger`目录
`relhassubclassbool` 如果表或索引具有（或曾经具有）任何继承子项，则为真(True)
`relrowsecuritybool` 如果表上启用了行级安全性则为真，参见 `pg_policy`目录
`relforcerowsecuritybool` 如果行级安全性（启用时）也适用于表拥有者则为真，参见 `pg_policy`目录
`relispopulatedbool` 如果表已被填充则为真（对于所有关系该列都为真，但对于某些物化视图却不是）
`relreplidentchar` 用来为行形成“replica identity”的列： `d`= 默认 (主键，如果存在), `n`= 无, `f`= 所有列 `i`= 索引的`indisreplident`被设置或者为默认
`relispartitionbool` 如果表或索引是一个分区，则为真
`relrewriteoid`(references `pg_class`.`oid`) 对于在要求表重写的DDL操作期间被写入的新关系，这个域包含原始关系的OID，否则为0。那种状态仅在内部可见，对于一个用户可见的关系这个域应该从不包含不是0的值。
`relfrozenxidxid` 在此之前的所有事务ID在表中已经被替换为一个永久的（“冻结的”) 事务ID。这用于跟踪表是否需要被清理，以便阻止事务ID回卷或者允许`pg_xact`被收缩。如果该关系不是一个表则为0（`InvalidTransactionId`）。
`relminmxidxid` 在此之前的多事务ID在表中已经被替换为一个事务ID。这被用于跟踪表是否需要被清理，以阻止多事务ID回卷或者允许`pg_multixact`被收缩。如果关系不是一个表则为0（`InvalidMultiXactId`）。
`relaclaclitem[]` 访问权限，更多信息参见第 5.7 节
`reloptionstext[]` 访问方法相关的选项，以“keyword=value”字符串形式
`relpartboundpg_node_tree` 如果表示一个分区（见`relispartition`），分区边界的内部表达

列类型

描述

oidoid

行标识符

relnamename

表、索引、视图等的名字

relnamespaceoid(references pg_namespace.oid)

包含该关系的名字空间的OID

reltypeoid(references pg_type.oid)

可能存在的表行类型所对应数据类型的OID（对索引为0，索引没有pg_type项）

reloftypeoid(references pg_type.oid)

对于有类型的表，为底层组合类型的OID，对于其他所有关系为0

relowneroid(references pg_authid.oid)

关系的拥有者

relamoid(references pg_am.oid)

如果这是一个表或者索引，表示索引使用的访问方法（堆、B树、哈希等）

relfilenodeoid

该关系的磁盘文件的名字，0表示这是一个“映射”关系，其磁盘文件名取决于低层状态

reltablespaceoid(references pg_tablespace.oid)

该关系所存储的表空间。如果为0，使用数据库的默认表空间。（如果关系无磁盘文件时无意义）

relpagesint4

该表磁盘表示的尺寸，以页面计（页面尺寸为BLCKSZ）。这只是一个由规划器使用的估计值。它被VACUUM、ANALYZE以及一些DDL命令（如CREATE INDEX）所更新。

reltuplesfloat4

表中的存活行数。这只是一个由规划器使用的估计值。它被VACUUM、ANALYZE以及一些DDL命令（如CREATE INDEX）所更新。

relallvisibleint4

在表的可见性映射表中被标记为全可见的页数。这只是一个由规划器使用的估计值。它被VACUUM、ANALYZE以及一些DDL命令（如CREATE INDEX）所更新。

reltoastrelidoid(references pg_class.oid)

与该表相关联的TOAST表的OID，如果没有则为0。TOAST表将大属性“线外”存储在一个二级表中。

relhasindexbool

如果这是一个表并且其上建有（或最近建有）索引则为真

relissharedbool

如果该表在集簇中的所有数据库间共享则为真。只有某些系统目录（如pg_database）是共享的。

relpersistencechar

p= 永久表，u= 无日志表， t= 临时表

relkindchar

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

relnattsint2

关系中用户列的数目（系统列不计算在内）。在pg_attribute中必须有这么多对应的项。另请参阅pg_attribute.attnum。

relchecksint2

表上CHECK约束的数目，参见pg_constraint目录

relhasrulesbool

如果表有（或曾有）规则则为真，参见pg_rewrite目录

relhastriggersbool

如果表有（或曾有）触发器则为真，参见 pg_trigger目录

relhassubclassbool

如果表或索引具有（或曾经具有）任何继承子项，则为真(True)

relrowsecuritybool

如果表上启用了行级安全性则为真，参见 pg_policy目录

relforcerowsecuritybool

如果行级安全性（启用时）也适用于表拥有者则为真，参见 pg_policy目录

relispopulatedbool

如果表已被填充则为真（对于所有关系该列都为真，但对于某些物化视图却不是）

relreplidentchar

用来为行形成“replica identity”的列： d= 默认 (主键，如果存在), n= 无, f= 所有列 i= 索引的indisreplident被设置或者为默认

relispartitionbool

如果表或索引是一个分区，则为真

relrewriteoid(references pg_class.oid)

对于在要求表重写的DDL操作期间被写入的新关系，这个域包含原始关系的OID，否则为0。那种状态仅在内部可见，对于一个用户可见的关系这个域应该从不包含不是0的值。

relfrozenxidxid

在此之前的所有事务ID在表中已经被替换为一个永久的（“冻结的”) 事务ID。这用于跟踪表是否需要被清理，以便阻止事务ID回卷或者允许pg_xact被收缩。如果该关系不是一个表则为0（InvalidTransactionId）。

relminmxidxid

在此之前的多事务ID在表中已经被替换为一个事务ID。这被用于跟踪表是否需要被清理，以阻止多事务ID回卷或者允许pg_multixact被收缩。如果关系不是一个表则为0（InvalidMultiXactId）。

relaclaclitem[]

访问权限，更多信息参见第 5.7 节

reloptionstext[]

访问方法相关的选项，以“keyword=value”字符串形式

relpartboundpg_node_tree

如果表示一个分区（见relispartition），分区边界的内部表达

pg_class中的一些逻辑标志被以一种懒惰的方式维护：在正确状态时它们被保证为真，但是当条件不再为真时它们并不会被立刻重置为假。例如，relhasindex由CREATE INDEX设置，但它从不会被DROP INDEX清除。作为替代，VACUUM会在找到无索引表后清除其 relhasindex。这种安排避免了竞争条件并且提高了并发性。

上一节： PostgreSQL pg_cast

下一节： PostgreSQL pg_collation

"PostgreSQL 13.1 中文入门教程"的目录

PostgreSQL 13.1 中文入门教程 PostgreSQL pg_class