Update (logical replication)

逻辑复制 Update 格式，表示更新消息。

当前查看 PostgreSQL 18.6。

说明

逻辑复制 Update 格式，表示更新消息。

层次: 逻辑复制载荷，与前后端消息封装分开。
首个字段: Byte1('U')

用法

Update

协议上下文

本节说明各逻辑复制消息的详细格式。这些消息由复制槽 SQL 接口返回，或由 walsender 发送。由 walsender 发送时，它们被封装在复制协议的 WAL 消息中（参见第 54.4 节），消息流程通常与物理复制相同。Stream Start、Stream Stop、Stream Commit 和 Stream Abort 从协议版本 2 起可用。Begin Prepare、Prepare、Commit Prepared、Rollback Prepared 和 Stream Prepare 从协议版本 3 起可用。以下消息部分为上述消息所共用。

按手册顺序排列的字段

位置	格式	含义
1	Byte1('U')	将该消息标识为 Update 消息。
2	Int32 (TransactionId)	事务的 XID，仅在流式传输事务中出现。此字段从协议版本 2 起可用。
3	Int32 (Oid)	关系的 OID，与 Relation 消息中的 ID 对应。
4	Byte1('K')	将后续 TupleData 子消息标识为键。此字段可选，仅在更新更改了属于 REPLICA IDENTITY 索引的某一列或多列的数据时出现。
5	Byte1('O')	将后续 TupleData 子消息标识为旧元组。此字段可选，仅在发生更新的表将 REPLICA IDENTITY 设为 FULL 时出现。
6	TupleData	表示旧元组或主键内容的 TupleData 消息部分。仅在前面的'O'或'K'部分存在时出现。
7	Byte1('N')	将后续 TupleData 消息标识为新元组。
8	TupleData	表示新元组内容的 TupleData 消息部分。

手册定义

Byte1('U')

将该消息标识为 Update 消息。

Int32 (TransactionId)

事务的 XID，仅在流式传输事务中出现。此字段从协议版本 2 起可用。

Int32 (Oid)

关系的 OID，与 Relation 消息中的 ID 对应。

Byte1('K')

将后续 TupleData 子消息标识为键。此字段可选，仅在更新更改了属于 REPLICA IDENTITY 索引的某一列或多列的数据时出现。

Byte1('O')

将后续 TupleData 子消息标识为旧元组。此字段可选，仅在发生更新的表将 REPLICA IDENTITY 设为 FULL 时出现。

TupleData

表示旧元组或主键内容的 TupleData 消息部分。仅在前面的'O'或'K'部分存在时出现。

Byte1('N')

将后续 TupleData 消息标识为新元组。

TupleData

表示新元组内容的 TupleData 消息部分。

Update 消息可以包含 'K' 消息部分或 'O' 消息部分，也可以两者都不包含，但绝不会同时包含两者。

文档与源码

PostgreSQL 18 English manual

来源构建

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

版本比较

PostgreSQL 13 → 14: 属性变化。

以下差异保留原始字段名与英文源描述。

--- PostgreSQL 13
+++ PostgreSQL 14
@@ -3,6 +3,10 @@
     {
       "description": "Identifies the message as an update message.",
       "format": "Byte1('U')"
+    },
+    {
+      "description": "Xid of the transaction (only present for streamed transactions). This field is available since protocol version 2.",
+      "format": "Int32"
     },
     {
       "description": "ID of the relation corresponding to the ID in the relation message.",

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

快速链接