Begin (logical replication)

逻辑复制 Begin 格式，表示事务开始消息。

当前查看 PostgreSQL 18.6。

说明

逻辑复制 Begin 格式，表示事务开始消息。

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

用法

Begin

协议上下文

本节说明各逻辑复制消息的详细格式。这些消息由复制槽 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('B')	将该消息标识为 Begin 消息。
2	Int64 (XLogRecPtr)	事务的最终 LSN。
3	Int64 (TimestampTz)	事务的提交时间戳。其值为自 PostgreSQL 纪元（2000-01-01）起经过的微秒数。
4	Int32 (TransactionId)	事务的 Xid。

手册定义

Byte1('B')

将该消息标识为 Begin 消息。

Int64 (XLogRecPtr)

事务的最终 LSN。

Int64 (TimestampTz)

事务的提交时间戳。其值为自 PostgreSQL 纪元（2000-01-01）起经过的微秒数。

Int32 (TransactionId)

事务的 Xid。

文档与源码

PostgreSQL 18 English manual

来源构建

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

版本比较

PostgreSQL 14 → 15: 属性变化。

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

--- PostgreSQL 14
+++ PostgreSQL 15
@@ -6,15 +6,15 @@
     },
     {
       "description": "The final LSN of the transaction.",
-      "format": "Int64"
+      "format": "Int64 (XLogRecPtr)"
     },
     {
       "description": "Commit timestamp of the transaction. The value is in number of microseconds since PostgreSQL epoch (2000-01-01).",
-      "format": "Int64"
+      "format": "Int64 (TimestampTz)"
     },
     {
       "description": "Xid of the transaction.",
-      "format": "Int32"
+      "format": "Int32 (TransactionId)"
     }
   ],
   "layer": "logical replication"

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

快速链接