Relation (logical replication)
逻辑复制 Relation 格式,表示关系消息。
当前查看 PostgreSQL 18.6。
说明
逻辑复制 Relation 格式,表示关系消息。
- 层次
- 逻辑复制载荷,与前后端消息封装分开。
- 首个字段
- Byte1('R')
用法
Relation协议上下文
本节说明各逻辑复制消息的详细格式。这些消息由复制槽 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('R') | 将该消息标识为 Relation 消息。 |
| 2 | Int32 (TransactionId) | 事务的 XID,仅在流式传输事务中出现。此字段从协议版本 2 起可用。 |
| 3 | Int32 (Oid) | 关系的OID。 |
| 4 | 字符串 | 命名空间(对于 pg_catalog 为空字符串)。 |
| 5 | 字符串 | 关系名称。 |
| 6 | Int8 | 关系的复制标识设置,与 pg_class 中的 relreplident 相同。 |
| 7 | Int16 | 列数。 |
| 8 | Int8 | 列的标志。目前可以为 0,表示没有标志;或为 1,标记该列是键的一部分。 |
| 9 | 字符串 | 列的名称。 |
| 10 | Int32 (Oid) | 列数据类型的OID。 |
| 11 | Int32 | 列的类型修饰符( atttypmod )。 |
手册定义
-
- Byte1('R')
-
将该消息标识为 Relation 消息。
- Int32 (TransactionId)
-
事务的 XID,仅在流式传输事务中出现。此字段从协议版本 2 起可用。
- Int32 (Oid)
-
关系的OID。
- 字符串
-
命名空间(对于
pg_catalog为空字符串)。 - 字符串
-
关系名称。
- Int8
-
关系的复制标识设置,与 pg_class 中的 relreplident 相同。
- Int16
-
列数。
接下来,发布中包含的每一列都会出现以下消息部分:
- Int8
-
列的标志。目前可以为 0,表示没有标志;或为 1,标记该列是键的一部分。
- 字符串
-
列的名称。
- Int32 (Oid)
-
列数据类型的OID。
- Int32
-
列的类型修饰符(
atttypmod)。
相关条目
文档与源码
来源构建
- 版本
- 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 a relation message.",
"format": "Byte1('R')"
+ },
+ {
+ "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.",
比较已记录的接口与属性,排除来源指纹和构建元数据。某个样本中没有记录,不能据此判断实际引入或移除的版本。
相关条目
Begin (logical replication)Begin Prepare (logical replication)Commit (logical replication)Commit Prepared (logical replication)Delete (logical replication)Insert (logical replication)Message (logical replication)Origin (logical replication)Prepare (logical replication)Rollback Prepared (logical replication)Stream Abort (logical replication)Stream Commit (logical replication)
导出 JSON · 返回协议消息 · 收录范围为 PostgreSQL 10 至 20;最早采样版本不一定是实际引入版本。