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

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

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 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 / 7.1

52.7. pg_attribute #

目录 pg_attribute 存储关于表列的信息。数据库中每个表的每一列,在 pg_attribute 中都恰好有一行。(其中也包括索引的属性项,实际上,凡是在 pg_class 中有项的对象,都有对应的属性项。)

术语属性等同于列,这里使用它只是出于历史原因。

表 52.7. pg_attribute 列

列类型

描述

attrelid oid(引用 pg_class.oid)

此列所属的表

attname name

列名称

atttypid oid(引用 pg_type.oid)

此列的数据类型(删除的列为零)

attlen int2

该列数据类型的 pg_type.typlen 副本

attnum int2

列的编号。一般列从 1 开始向上编号。系统列,如 ctid,则拥有(任意)负值编号。

atttypmod int4

atttypmod 记录了在表创建时提供的类型相关数据(例如一个 varchar 列的最大长度)。它会被传递给类型相关的输入函数和长度强制转换函数。对于那些不需要 atttypmod 的类型,这个值通常为 -1。

attndims int2

如果该列是数组类型,则为维数;否则为 0。(目前并不会强制检查数组维数,因此任何非零值实际上都只意味着“这是一个数组”。)

attbyval bool

该列类型的 pg_type.typbyval 的一个拷贝

attalign char

该列类型的 pg_type.typalign 的一个拷贝

attstorage char

通常是该列类型的 pg_type.typstorage 的一个拷贝。对于可 TOAST 的数据类型,这可以在列创建后被修改以控制存储策略。

attcompression char

该列当前的压缩方法。通常为'\0',表示使用当前默认设置(见 default_toast_compression)。否则,'p' 选择 pglz 压缩,而'l' 选择 LZ4 压缩。但是,当 attstorage 不允许压缩时,该字段会被忽略。

attnotnull bool

此列具有一个非空约束(可能尚未验证)

atthasdef bool

该列有一个默认表达式或生成表达式,在此情况下在 pg_attrdef 目录中会有一个对应项来真正定义该表达式。(检查 attgenerated 以确定是默认还是生成表达式。)

atthasmissing bool

此列有一个值,供该列在数据行中完全缺失时使用;在数据行创建之后添加带有非易失性 DEFAULT 值的列时,就会出现这种情况。实际使用的值存储在 attmissingval 列中。

attidentity char

如果是一个零字节(''),则不是一个标识列。否则,a = 总是生成,d = 默认生成。

attgenerated char

如果是零字节(''),则不是生成列。否则,s = 存储式(stored),v = 虚拟(virtual)。存储式生成列会像普通列一样实际存储;虚拟生成列则在物理上存储为空值,实际值在运行时计算。

attisdropped bool

该列被删除且不再有效。一个删除的列仍然物理存在于表中,但是会被解析器忽略并因此无法通过 SQL 访问。

attislocal bool

该列是由关系本地定义的。注意一个列可以同时是本地定义和继承的。

attinhcount int2

该列直接祖先的数量。祖先数量非零的列不能被删除,也不能被重命名。

attcollation oid(引用 pg_collation.oid)

该列定义的排序规则;如果该列的数据类型不支持排序规则,则为零。

attstattarget int2

attstattarget 控制 ANALYZE 为该列收集统计信息时的细节级别。零值表示不应收集统计信息。空值表示使用系统默认统计目标。正值的确切含义依赖于数据类型。对于标量数据类型,attstattarget 既是要收集的“高频值”目标个数,也是要创建的直方图桶目标个数。

attacl aclitem[]

列级访问权限,如果此列上已有特别授予的权限

attoptions text[]

属性级选项,以“keyword=value”形式的字符串

attfdwoptions text[]

属性级的外部数据包装器选项,以“keyword=value”形式的字符串

attmissingval anyarray

此列包含一个单元素数组,其中的值供该列在数据行中完全缺失时使用;在数据行创建之后添加带有非易失性 DEFAULT 值的列时,就会出现这种情况。只有 atthasmissing 为真时才使用此值。如果没有这样的值,则此列为 NULL。


在被删除列的 pg_attribute 条目中,atttypid 被重置为零,但 attlen 以及其他从 pg_type 复制的字段仍然有效。这种安排用于应对被删除列的数据类型后来也被删除、因而不再有相应 pg_type 行的情况。attlen 和其他字段可用于解释表中一行的内容。

报告文档问题

阅读 上游文档. 通过 PostgreSQL 文档反馈表单.