↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

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

DataRow

DataRow 是后端协议消息,表示一行数据。

当前查看 PostgreSQL 18.6。

说明

DataRow 是后端协议消息,表示一行数据。

方向
后端 → 前端
首个线上协议字段
Byte1('D')
字段条目
5
手册中的交互阶段
简单查询

用法

DataRow (B)

消息边界与重复字段

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

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

位置格式含义
1Byte1('D')标识消息为数据行。
2Int32消息内容的长度(以字节为单位),包括其自身。
3Int16后面跟着的列值的数量(可能为零)。
4Int32列值的长度,以字节为单位(不包括此长度字段本身)。可以为零。特殊值 -1 表示 NULL 列值。为 NULL 时,后面不再有值的字节。
5Byte n列的值,格式由相关的格式代码指示。 n 是上述长度。

手册定义

Byte1('D')

标识消息为数据行。

Int32

消息内容的长度(以字节为单位),包括其自身。

Int16

后面跟着的列值的数量(可能为零)。

接下来,每列都有以下两个字段:

Int32

列值的长度,以字节为单位(不包括此长度字段本身)。可以为零。特殊值 -1 表示 NULL 列值。为 NULL 时,后面不再有值的字节。

Byte n

列的值,格式由相关的格式代码指示。n是上述长度。

相关条目

文档与源码

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

版本比较

PostgreSQL 17 → 18: 无变化。

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

相关条目

导出 JSON · 返回协议消息 · 收录范围为 PostgreSQL 10 至 20;最早采样版本不一定是实际引入版本。