支持的版本: 当前 (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

35.17. columns #

视图 columns 包含数据库中所有表列(或视图列)的信息。不包括系统列(ctid 等)。仅显示当前用户有权访问的列(通过作为所有者或拥有某些特权)。

表 35.15. columns

列名 类型

描述

table_catalog sql_identifier

包含表的数据库的名称(始终为当前数据库)

table_schema sql_identifier

包含表的模式的名称

table_name sql_identifier

表的名称

column_name sql_identifier

列的名称

ordinal_position cardinal_number

列在表中的序号位置(从 1 开始计数)

column_default character_data

列的默认表达式

is_nullable yes_or_no

如果列可能为空,则为 YES,如果已知列不可为空,则为 NO。非空约束是列可能已知为不可为空的一种方式,但可能还有其他方式。

data_type character_data

列的数据类型,如果它是内置类型,或者如果是某种数组则为 ARRAY(在这种情况下,请参阅视图 element_types),否则为 USER-DEFINED(在这种情况下,类型在 udt_name 和关联的列中标识)。如果列基于域,则此列引用该域的基础类型(并且该域在 domain_name 和关联的列中标识)。

character_maximum_length cardinal_number

如果 data_type 标识字符或位字符串类型,则为声明的最大长度;对于所有其他数据类型或未声明最大长度的情况,则为 null。

character_octet_length cardinal_number

如果 data_type 标识字符类型,则为数据以八位字节(字节)为单位的最大可能长度;对于所有其他数据类型则为 null。最大八位字节长度取决于声明的字符最大长度(见上文)和服务器编码。

numeric_precision cardinal_number

如果 data_type 标识数值类型,则此列包含此列的类型(声明的或隐式的)精度。精度指示有效数字的位数。它可以以十进制(以 10 为基数)或二进制(以 2 为基数)表示,如列 numeric_precision_radix 中指定。对于所有其他数据类型,此列为 null。

numeric_precision_radix cardinal_number

如果 data_type 标识数值类型,则此列指示列 numeric_precisionnumeric_scale 中的值以哪个基数表示。该值为 2 或 10。对于所有其他数据类型,此列为 null。

numeric_scale cardinal_number

如果 data_type 标识精确数值类型,则此列包含此列的类型(声明的或隐式的)比例。比例指示小数点右侧的有效数字的位数。它可以以十进制(以 10 为基数)或二进制(以 2 为基数)表示,如列 numeric_precision_radix 中指定。对于所有其他数据类型,此列为 null。

datetime_precision cardinal_number

如果 data_type 标识日期、时间、时间戳或间隔类型,则此列包含此列的类型的(声明的或隐式的)小数秒精度,即秒值中小数点后维护的十进制位数。对于所有其他数据类型,此列为 null。

interval_type character_data

如果 data_type 标识间隔类型,则此列包含此列的间隔包括的字段的规范,例如,YEAR TO MONTHDAY TO SECOND 等。如果没有指定字段限制(即,间隔接受所有字段),并且对于所有其他数据类型,此字段为 null。

interval_precision cardinal_number

适用于 PostgreSQL 中不可用的功能(有关间隔类型列的小数秒精度,请参阅 datetime_precision

character_set_catalog sql_identifier

适用于 PostgreSQL 中不可用的功能

character_set_schema sql_identifier

适用于 PostgreSQL 中不可用的功能

character_set_name sql_identifier

适用于 PostgreSQL 中不可用的功能

collation_catalog sql_identifier

包含列排序规则的数据库的名称(始终为当前数据库),如果为默认值或列的数据类型不可排序,则为 null

collation_schema sql_identifier

包含列排序规则的模式的名称,如果为默认值或列的数据类型不可排序,则为 null

collation_name sql_identifier

列排序规则的名称,如果为默认值或列的数据类型不可排序,则为 null

domain_catalog sql_identifier

如果列具有域类型,则为定义该域的数据库的名称(始终为当前数据库),否则为 null。

domain_schema sql_identifier

如果列具有域类型,则为定义该域的模式的名称,否则为 null。

domain_name sql_identifier

如果列具有域类型,则为域的名称,否则为 null。

udt_catalog sql_identifier

定义列数据类型(如果适用,则为域的底层类型)的数据库的名称(始终为当前数据库)

udt_schema sql_identifier

定义列数据类型(如果适用,则为域的底层类型)的模式的名称

udt_name sql_identifier

列数据类型(如果适用,则为域的底层类型)的名称

scope_catalog sql_identifier

适用于 PostgreSQL 中不可用的功能

scope_schema sql_identifier

适用于 PostgreSQL 中不可用的功能

scope_name sql_identifier

适用于 PostgreSQL 中不可用的功能

maximum_cardinality cardinal_number

始终为 null,因为在 PostgreSQL 中数组始终具有无限的最大基数

dtd_identifier sql_identifier

列的数据类型描述符的标识符,在与表相关的数据类型描述符中是唯一的。这主要用于与其他此类标识符的实例进行连接。(标识符的特定格式未定义,并且不保证在未来版本中保持不变。)

is_self_referencing yes_or_no

适用于 PostgreSQL 中不可用的功能

is_identity yes_or_no

如果列是标识列,则为 YES,否则为 NO

identity_generation character_data

如果列是标识列,则为 ALWAYSBY DEFAULT,反映了列的定义。

identity_start character_data

如果列是标识列,则为内部序列的起始值,否则为 null。

identity_increment character_data

如果列是标识列,则为内部序列的增量,否则为 null。

identity_maximum character_data

如果列是标识列,则为内部序列的最大值,否则为 null。

identity_minimum character_data

如果列是标识列,则为内部序列的最小值,否则为 null。

identity_cycle yes_or_no

如果列是标识列,则如果内部序列循环则为 YES,如果不循环则为 NO;否则为 null。

is_generated character_data

如果列是生成列,则为 ALWAYS,否则为 NEVER

generation_expression character_data

如果列是生成列,则为生成表达式,否则为 null。

is_updatable yes_or_no

如果列可更新,则为 YES,否则为 NO(基本表中的列始终可更新,视图中的列不一定)


由于在 SQL 中数据类型可以用多种方式定义,并且 PostgreSQL 包含定义数据类型的其他方式,因此它们在信息模式中的表示可能有些困难。列 data_type 应该标识列的底层内置类型。在 PostgreSQL 中,这意味着该类型是在系统目录模式 pg_catalog 中定义的。如果应用程序可以特别处理众所周知的内置类型(例如,以不同方式格式化数字类型或使用精度列中的数据),则此列可能很有用。列 udt_nameudt_schemaudt_catalog 始终标识列的底层数据类型,即使该列是基于域的。(由于 PostgreSQL 将内置类型视为用户定义类型,因此内置类型也会在此处显示。这是 SQL 标准的扩展。)如果应用程序想要根据类型以不同的方式处理数据,则应使用这些列,因为在这种情况下,列是否真的基于域并不重要。如果列是基于域的,则域的标识存储在列 domain_namedomain_schemadomain_catalog 中。 如果你想将列与其关联的数据类型配对,并将域视为单独的类型,你可以写 coalesce(domain_name, udt_name) 等。

提交更正

如果您发现文档中有任何不正确、与您使用特定功能的经验不符或需要进一步澄清的地方,请使用此表格报告文档问题。