历史版本。 PostgreSQL 12 已结束支持。 2024-11-21. 请参阅 当前版本手册.
51.7. pg_attribute #
目录 pg_attribute 存储关于表列的信息。数据库中每个表的每一列，在 pg_attribute 中都恰好有一行。（其中也包括索引的属性项，实际上，凡是在 pg_class 中有项的对象，都有对应的属性项。）
术语属性等同于列，这里使用它只是出于历史原因。
表 51.7. pg_attribute 列
| 名称 | 类型 | 引用 | 描述 |
|---|---|---|---|
attrelid | oid | | 此列所属的表 |
attname | name | 列名称 | |
atttypid | oid | | 此列的数据类型 |
attstattarget | int4 |
attstattarget 控制 ANALYZE 为该列收集统计信息时的细节级别。零值表示不应收集统计信息。负值表示使用系统默认统计目标。正值的确切含义依赖于数据类型。对于标量数据类型，attstattarget 既是要收集的“高频值”目标个数，也是要创建的直方图桶目标个数。
| |
attlen | int2 |
该列数据类型的 pg_type.typlen 副本
| |
attnum | int2 |
列的编号。一般列从 1 开始向上编号。系统列，如 ctid，则拥有（任意）负值编号。
| |
attndims | int4 | 如果该列是数组类型，则为维数；否则为 0。（目前并不会强制检查数组维数，因此任何非零值实际上都只意味着“这是一个数组”。） | |
attcacheoff | int4 | 在存储中总是 -1，但加载到内存中的行描述符后，此值可能被更新，用于缓存该属性在行内的偏移量 | |
atttypmod | int4 |
atttypmod 记录了在表创建时提供的类型相关数据（例如一个 varchar 列的最大长度）。它会被传递给类型相关的输入函数和长度强制转换函数。对于那些不需要 atttypmod 的类型，这个值通常为 -1。
| |
attbyval | bool |
该列类型的 pg_type.typbyval 的一个拷贝
| |
attstorage | char |
通常是该列类型的 pg_type.typstorage 的一个拷贝。对于可 TOAST 的数据类型，这可以在列创建后被修改以控制存储策略。
| |
attalign | char |
该列类型的 pg_type.typalign 的一个拷贝
| |
attnotnull | bool | 这代表一个非空约束 | |
atthasdef | bool |
该列有一个默认表达式或生成表达式，在此情况下在 pg_attrdef 目录中会有一个对应项来真正定义该表达式。（检查 attgenerated 以确定是默认还是生成表达式。）
| |
atthasmissing | bool |
此列有一个值，供该列在数据行中完全缺失时使用；在数据行创建之后添加带有非易失性 DEFAULT 值的列时，就会出现这种情况。实际使用的值存储在 attmissingval 列中。
| |
attidentity | char |
如果是一个零字节（''），则不是一个标识列。否则，a = 总是生成，d = 默认生成。
| |
attgenerated | char |
如果是零字节（''），则不是生成列。否则，s = 存储式。（将来可能会添加其他值。）
| |
attisdropped | bool | 该列被删除且不再有效。一个删除的列仍然物理存在于表中，但是会被解析器忽略并因此无法通过 SQL 访问。 | |
attislocal | bool | 该列是由关系本地定义的。注意一个列可以同时是本地定义和继承的。 | |
attinhcount | int4 | 该列直接祖先的数量。祖先数量非零的列不能被删除，也不能被重命名。 | |
attcollation | oid | | 该列定义的排序规则；如果该列的数据类型不支持排序规则，则为零。 |
attacl | aclitem[] | 列级访问权限，如果此列上已有特别授予的权限 | |
attoptions | text[] | 属性级选项，以“keyword=value”形式的字符串 | |
attfdwoptions | text[] | 属性级的外部数据包装器选项，以“keyword=value”形式的字符串 | |
attmissingval | anyarray |
此列包含一个单元素数组，其中的值供该列在数据行中完全缺失时使用；在数据行创建之后添加带有非易失性 DEFAULT 值的列时，就会出现这种情况。只有 atthasmissing 为真时才使用此值。如果没有这样的值，则此列为 NULL。
|
在被删除列的 pg_attribute 条目中，atttypid 被重置为零，但 attlen 以及其他从 pg_type 复制的字段仍然有效。这种安排用于应对被删除列的数据类型后来也被删除、因而不再有相应 pg_type 行的情况。attlen 和其他字段可用于解释表中一行的内容。