百科 / 协议消息 / 后端消息

RowDescription

当前查看 PostgreSQL 18。

中文定义与说明

协议消息 RowDescription (B)。

同版本中文手册定义

Byte1('T'): 标识消息为行描述。
Int32: 消息内容的长度（以字节为单位），包括其自身。
Int16: 指定一行中的字段数量（可以为零）。

接下来，每个字段都有以下内容：

String: 字段名称。
Int32: 如果能够确定该字段是某个特定表的列，则为该表的对象 ID；否则为零。
Int16: 如果能够确定该字段是某个特定表的列，则为该列的属性编号；否则为零。
Int32: 字段数据类型的对象 ID。
Int16: 数据类型大小（参见 pg_type.typlen）。注意，负值表示可变宽度类型。
Int32: 类型修饰符（参见 pg_attribute.atttypmod）。修饰符的含义是特定于类型的。
Int16: 字段所使用的格式代码。目前为零（文本）或一（二进制）。对于 Describe 针对预备语句的变体所返回的 RowDescription，格式代码尚未确定，始终为零。

查看完整中文手册与上下文。

说明

Byte1('T') 标识消息为行描述。 Int32 消息内容的长度（以字节为单位），包括其自身。 Int16 指定一行中的字段数量（可以为零）。接下来，每个字段都有以下内容： String 字段名称。 Int32 如果能够确定该字段是某个特定表的列，则为该表的对象 ID；否则为零。 Int16 如果能够确定该字段是某个特定表的列，则为该列的属性编号；否则为零。 Int32 字段数据类型的对象 ID。 Int16 数据类型大小（参见 pg_type.typlen ）。注意，负值表示可变宽度类型。 Int32 类型修饰符（参见 pg_attribute.atttypmod ）。修饰符的含义是特定于类型的。 Int16 字段所使用的格式代码。目前为零（文本）或一（二进制）。对于 Describe 针对预备语句的变体所返回的 RowDescription，格式代码尚未确定，始终为零。

方向: 后端 → 前端
首个线上协议字段: Byte1('T')
字段条目: 10
手册中的交互阶段: 简单查询；扩展查询

用法

RowDescription (B)

消息边界与重复字段

下方完整定义保留重复项、计数与条件字段。表格行号表示文档中的字段定义，并非固定字节偏移量。整数编码与交互流程以同版本协议章节为准。

按手册顺序排列的线上协议字段

位置	格式	含义
1	Byte1('T')	标识消息为行描述。
2	Int32	消息内容的长度（以字节为单位），包括其自身。
3	Int16	指定一行中的字段数量（可以为零）。
4	字符串	字段名称。
5	Int32	如果能够确定该字段是某个特定表的列，则为该表的对象 ID；否则为零。
6	Int16	如果能够确定该字段是某个特定表的列，则为该列的属性编号；否则为零。
7	Int32	字段数据类型的对象 ID。
8	Int16	数据类型大小（参见 pg_type.typlen ）。注意，负值表示可变宽度类型。
9	Int32	类型修饰符（参见 pg_attribute.atttypmod ）。修饰符的含义是特定于类型的。
10	Int16	字段所使用的格式代码。目前为零（文本）或一（二进制）。对于 Describe 针对预备语句的变体所返回的 RowDescription，格式代码尚未确定，始终为零。

文档与源码

PostgreSQL 18 English manual

来源构建

版本: 18.6
构建: https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
来源指纹: 555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f

版本比较

PostgreSQL 17 → 18: 无变化。

比较已记录的接口与属性，排除来源指纹和构建元数据。某个样本中没有记录，不能据此判断实际引入或移除的版本。

快速链接