Stream Abort (logical replication)

逻辑复制 Stream Abort 格式，表示流式事务中止消息。

当前查看 PostgreSQL 18.6。

说明

逻辑复制 Stream Abort 格式，表示流式事务中止消息。

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

用法

Stream Abort

协议上下文

本节说明各逻辑复制消息的详细格式。这些消息由复制槽 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('A')	将该消息标识为 Stream Abort 消息。
2	Int32 (TransactionId)	事务的 Xid。
3	Int32 (TransactionId)	子事务的Xid（对于顶层事务，将与事务的xid相同）。
4	Int64 (XLogRecPtr)	中止操作的 LSN，仅在 streaming 设置为 parallel 时出现。此字段从协议版本 4 起可用。
5	Int64 (TimestampTz)	事务中止时间戳，仅在 streaming 设置为 parallel 时出现。其值为自 PostgreSQL 纪元（2000-01-01）以来的微秒数。此字段从协议版本 4 起可用。

手册定义

Byte1('A')

将该消息标识为 Stream Abort 消息。

Int32 (TransactionId)

事务的 Xid。

Int32 (TransactionId)

子事务的Xid（对于顶层事务，将与事务的xid相同）。

Int64 (XLogRecPtr)

中止操作的 LSN，仅在 streaming 设置为 parallel 时出现。此字段从协议版本 4 起可用。

Int64 (TimestampTz)

事务中止时间戳，仅在 streaming 设置为 parallel 时出现。其值为自 PostgreSQL 纪元（2000-01-01）以来的微秒数。此字段从协议版本 4 起可用。

文档与源码

PostgreSQL 18 English manual

来源构建

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

版本比较

PostgreSQL 15 → 16: 属性变化。

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

--- PostgreSQL 15
+++ PostgreSQL 16
@@ -11,6 +11,14 @@
     {
       "description": "Xid of the subtransaction (will be same as xid of the transaction for top-level transactions).",
       "format": "Int32 (TransactionId)"
+    },
+    {
+      "description": "The LSN of the abort operation, present only when streaming is set to parallel. This field is available since protocol version 4.",
+      "format": "Int64 (XLogRecPtr)"
+    },
+    {
+      "description": "Abort timestamp of the transaction, present only when streaming is set to parallel. The value is in number of microseconds since PostgreSQL epoch (2000-01-01). This field is available since protocol version 4.",
+      "format": "Int64 (TimestampTz)"
     }
   ],
   "layer": "logical replication"

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

快速链接