{"Entry":{"collection":"protocol","key":"logical-delete","name":"Delete (logical replication)","aliases":["Delete"],"metadata":{"aliases":["Delete"],"category":"Logical replication formats","content_hash":"93c48c38494162e37b779dfe94a68df9fb96acae78725728f64dc455b4624fcd","derived_content_hash":"c16c6e8405ef51f3d24cb6ad326e6f462516cbcd538066553dd94452b9704ca1","imported_at":"2026-09-30T00:40:44.618632+08:00","name":"Delete (logical replication)","name_zh":"","slug":"logical-delete","summary":"Logical replication Delete format. Identifies the message as a delete message."}},"Definition":{"Collection":"protocol","Key":"logical-delete","SourceDatabase":"center","Version":"18","SourceTable":"protocol_message","SourceKey":"logical-delete","SourceRevision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","Facts":{"comparison_data":{"fields":[{"description":"Identifies the message as a delete message.","format":"Byte1('D')"},{"description":"Xid of the transaction (only present for streamed transactions). This field is available since protocol version 2.","format":"Int32 (TransactionId)"},{"description":"OID of the relation corresponding to the ID in the relation message.","format":"Int32 (Oid)"},{"description":"Identifies the following TupleData submessage as a key. This field is present if the table in which the delete has happened uses an index as REPLICA IDENTITY.","format":"Byte1('K')"},{"description":"Identifies the following TupleData message as an old tuple. This field is present if the table in which the delete happened has REPLICA IDENTITY set to FULL.","format":"Byte1('O')"},{"description":"TupleData message part representing the contents of the old tuple or primary key, depending on the previous field.","format":"TupleData"}],"layer":"logical replication"},"comparison_hash":"9022c0a1dbfe8824c1c59e3f8148a057e31c9d3edb2919fc83764704f181462c","description":["Logical replication Delete format. Identifies the message as a delete message."],"description_zh":"Byte1('D') 将该消息标识为 Delete 消息。 Int32 (TransactionId) 事务的 Xid（仅在流式传输的事务中出现）。此字段从协议版本 2 起可用。 Int32 (Oid) 关系的 OID，与 Relation 消息中的 ID 对应。 Byte1('K') 将后续 TupleData 子消息标识为键。如果发生删除的表使用索引作为 REPLICA IDENTITY，则出现此字段。 Byte1('O') 将后续 TupleData 消息标识为旧元组。如果发生删除的表将 REPLICA IDENTITY 设为 FULL，则出现此字段。 TupleData 表示旧元组或主键内容的 TupleData 消息部分，具体取决于前一个字段。 Delete 消息可以包含 'K' 消息部分或 'O' 消息部分，但绝不会同时包含两者。","description_zh_html":"\u003cp\u003e协议消息 Delete。\u003c/p\u003e\u003ch3\u003e同版本中文手册定义\u003c/h3\u003e\u003cdd\u003e\u003cdiv class=\"variablelist\"\u003e\u003cdl class=\"variablelist\"\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003eByte1('D')\u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         将该消息标识为 Delete 消息。\n        \u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003eInt32 (TransactionId)\u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         事务的 Xid（仅在流式传输的事务中出现）。此字段从协议版本 2 起可用。\n        \u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003eInt32 (Oid)\u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         关系的 OID，与 Relation 消息中的 ID 对应。\n        \u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003eByte1('K')\u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         将后续 TupleData 子消息标识为键。如果发生删除的表使用索引作为 REPLICA IDENTITY，则出现此字段。\n        \u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003eByte1('O')\u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         将后续 TupleData 消息标识为旧元组。如果发生删除的表将 REPLICA IDENTITY 设为 FULL，则出现此字段。\n        \u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003eTupleData\u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         表示旧元组或主键内容的 TupleData 消息部分，具体取决于前一个字段。\n        \u003c/p\u003e\u003c/dd\u003e\u003c/dl\u003e\u003c/div\u003e\u003cp\u003e\n      Delete 消息可以包含 'K' 消息部分或 'O' 消息部分，但绝不会同时包含两者。\n     \u003c/p\u003e\u003c/dd\u003e\u003cp\u003e\u003ca href=\"/zh/docs/18/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-DELETE\"\u003e查看完整中文手册与上下文\u003c/a\u003e。\u003c/p\u003e","facts":[{"label":"Layer","value":"Logical replication payload; distinct from the frontend/backend message envelope"},{"label":"First field","value":"Byte1('D')"}],"facts_zh":[{"label":"层次","value":"逻辑复制载荷，与前后端消息封装分开。"},{"label":"首个字段","value":"Byte1('D')"}],"fields":[{"description":"Identifies the message as a delete message.","format":"Byte1('D')"},{"description":"Xid of the transaction (only present for streamed transactions). This field is available since protocol version 2.","format":"Int32 (TransactionId)"},{"description":"OID of the relation corresponding to the ID in the relation message.","format":"Int32 (Oid)"},{"description":"Identifies the following TupleData submessage as a key. This field is present if the table in which the delete has happened uses an index as REPLICA IDENTITY.","format":"Byte1('K')"},{"description":"Identifies the following TupleData message as an old tuple. This field is present if the table in which the delete happened has REPLICA IDENTITY set to FULL.","format":"Byte1('O')"},{"description":"TupleData message part representing the contents of the old tuple or primary key, depending on the previous field.","format":"TupleData"}],"manual_html":"\u003cdl\u003e\u003cdd\u003e\n\u003cdiv class=\"variablelist\"\u003e\n\u003cdl class=\"variablelist\"\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eByte1('D')\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eIdentifies the message as a delete message.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eInt32 (TransactionId)\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eXid of the transaction (only present for streamed transactions). This field is available since protocol version 2.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eInt32 (Oid)\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eOID of the relation corresponding to the ID in the relation message.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eByte1('K')\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eIdentifies the following TupleData submessage as a key. This field is present if the table in which the delete has happened uses an index as REPLICA IDENTITY.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eByte1('O')\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eIdentifies the following TupleData message as an old tuple. This field is present if the table in which the delete happened has REPLICA IDENTITY set to FULL.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eTupleData\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eTupleData message part representing the contents of the old tuple or primary key, depending on the previous field.\u003c/p\u003e\n\u003c/dd\u003e\n\u003c/dl\u003e\n\u003c/div\u003e\n\u003cp\u003eThe Delete message may contain either a 'K' message part or an 'O' message part, but never both of them.\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e","manual_path":"/docs/18/protocol-logicalrep-message-formats.html","related":[{"label":"Streaming replication protocol","url":"/docs/18/protocol-replication.html"},{"label":"Logical Decoding Plugins","url":"/wiki/decode/?v=18"}],"release":{"channel":"stable","label":"18.6","major":"18","ref":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2","revision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"},"sections":[{"paragraphs":["This section describes the detailed format of each logical replication message. These messages are either returned by the replication slot SQL interface or are sent by a walsender. In the case of a walsender, they are encapsulated inside replication protocol WAL messages as described in Section 54.4 , and generally obey the same message flow as physical replication. The following messages (Stream Start, Stream Stop, Stream Commit, and Stream Abort) are available since protocol version 2. The following messages (Begin Prepare, Prepare, Commit Prepared, Rollback Prepared, Stream Prepare) are available since protocol version 3. The following message parts are shared by the above messages."],"title":"Protocol context"}],"sections_zh":[{"paragraphs":["本节说明各逻辑复制消息的详细格式。这些消息由复制槽 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 起可用。以下消息部分为上述消息所共用。"],"title":"协议上下文"}],"signature":"Delete","sources":[{"label":"PostgreSQL 18 English manual","path":"protocol-logicalrep-message-formats.html","sha256":"e976b008206820fbeb1eba226e69bb7c00af157372c3545375d1b5053c76d0ad","url":"/docs/18/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-DELETE"}],"tables":[{"columns":[{"key":"c0","label":"Position"},{"key":"c1","label":"Format"},{"key":"c2","label":"Meaning"}],"key":"fields","rows":[{"c0":"1","c1":"Byte1('D')","c2":"Identifies the message as a delete message."},{"c0":"2","c1":"Int32 (TransactionId)","c2":"Xid of the transaction (only present for streamed transactions). This field is available since protocol version 2."},{"c0":"3","c1":"Int32 (Oid)","c2":"OID of the relation corresponding to the ID in the relation message."},{"c0":"4","c1":"Byte1('K')","c2":"Identifies the following TupleData submessage as a key. This field is present if the table in which the delete has happened uses an index as REPLICA IDENTITY."},{"c0":"5","c1":"Byte1('O')","c2":"Identifies the following TupleData message as an old tuple. This field is present if the table in which the delete happened has REPLICA IDENTITY set to FULL."},{"c0":"6","c1":"TupleData","c2":"TupleData message part representing the contents of the old tuple or primary key, depending on the previous field."}],"title":"Fields in documented order"}],"tables_zh":[{"columns":[{"key":"c0","label":"位置"},{"key":"c1","label":"格式"},{"key":"c2","label":"含义"}],"key":"fields","rows":[{"c0":"1","c1":"Byte1('D')","c2":"将该消息标识为 Delete 消息。"},{"c0":"2","c1":"Int32 (TransactionId)","c2":"事务的 XID，仅在流式传输事务中出现。此字段从协议版本 2 起可用。"},{"c0":"3","c1":"Int32 (Oid)","c2":"关系的 OID，与 Relation 消息中的 ID 对应。"},{"c0":"4","c1":"Byte1('K')","c2":"将后续 TupleData 子消息标识为键。如果发生删除的表使用索引作为 REPLICA IDENTITY，则出现此字段。"},{"c0":"5","c1":"Byte1('O')","c2":"将后续 TupleData 消息标识为旧元组。如果发生删除的表将 REPLICA IDENTITY 设为 FULL，则出现此字段。"},{"c0":"6","c1":"TupleData","c2":"表示旧元组或主键内容的 TupleData 消息部分，具体取决于前一个字段。"}],"title":"按手册顺序排列的字段"}],"zh_from":{"authored_translation":"source-derived-identity","body_sha256":"54a009e0d5a129be1e3b4c05f1eddc2e3471c0baafa60963b79d8129dbdb996e","kind":"same-version-chinese-manual-with-source-derived-identity","manual":{"anchor":"PROTOCOL-LOGICALREP-MESSAGE-FORMATS-DELETE","build_id":107,"extraction":"exact-definition","fragment_sha256":"d2542b4211ef1dc54011852d9453a13bc6e305944482f977c38255bf07afd471","locale":"zh-Hans","page_key":"protocol-logicalrep-message-formats.html","source_hash":"9561d3a39aca911a61b68b188aa97828e60fb6f7d81323d8aada08fe67259039","source_revision":"unknown:rendered-translation-baseline","translated_from_revision":null,"translation_revision":"git:b1b500221dbe5437cfca004d6b04d3f6e422765d;html-sha256:08e987a66af27b98444a8057c256314eafa13611a3fb9e888214fc436824244b","url":"/zh/docs/18/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-DELETE","version":"18"},"runtime_rerun":false,"source_facts_revision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}},"ManualEvidence":{"manual_path":"/docs/18/protocol-logicalrep-message-formats.html","release":{"channel":"stable","label":"18.6","major":"18","ref":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2","revision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"},"sources":[{"label":"PostgreSQL 18 English manual","path":"protocol-logicalrep-message-formats.html","sha256":"e976b008206820fbeb1eba226e69bb7c00af157372c3545375d1b5053c76d0ad","url":"/docs/18/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-DELETE"}]},"MeasuredEvidence":{}},"Text":{"Collection":"protocol","Key":"logical-delete","SourceDatabase":"center","Version":"18","Locale":"en","Title":"Delete (logical replication)","Summary":"Logical replication Delete format. Identifies the message as a delete message.","BodyHTML":"\u003cdl\u003e\u003cdd\u003e\n\u003cdiv\u003e\n\u003cdl\u003e\n\u003cdt\u003e\u003cspan\u003eByte1(\u0026#39;D\u0026#39;)\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eIdentifies the message as a delete message.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan\u003eInt32 (TransactionId)\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eXid of the transaction (only present for streamed transactions). This field is available since protocol version 2.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan\u003eInt32 (Oid)\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eOID of the relation corresponding to the ID in the relation message.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan\u003eByte1(\u0026#39;K\u0026#39;)\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eIdentifies the following TupleData submessage as a key. This field is present if the table in which the delete has happened uses an index as REPLICA IDENTITY.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan\u003eByte1(\u0026#39;O\u0026#39;)\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eIdentifies the following TupleData message as an old tuple. This field is present if the table in which the delete happened has REPLICA IDENTITY set to FULL.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan\u003eTupleData\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eTupleData message part representing the contents of the old tuple or primary key, depending on the previous field.\u003c/p\u003e\n\u003c/dd\u003e\n\u003c/dl\u003e\n\u003c/div\u003e\n\u003cp\u003eThe Delete message may contain either a \u0026#39;K\u0026#39; message part or an \u0026#39;O\u0026#39; message part, but never both of them.\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e","SourceRevision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","ContentHash":"8fe2e24507bb0e69af6cdcb774b4d3850c4bba785d3bdb623bb2b513dbafbc5f","Payload":{"description":["Logical replication Delete format. Identifies the message as a delete message."],"manual_html":"\u003cdl\u003e\u003cdd\u003e\n\u003cdiv class=\"variablelist\"\u003e\n\u003cdl class=\"variablelist\"\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eByte1('D')\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eIdentifies the message as a delete message.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eInt32 (TransactionId)\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eXid of the transaction (only present for streamed transactions). This field is available since protocol version 2.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eInt32 (Oid)\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eOID of the relation corresponding to the ID in the relation message.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eByte1('K')\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eIdentifies the following TupleData submessage as a key. This field is present if the table in which the delete has happened uses an index as REPLICA IDENTITY.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eByte1('O')\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eIdentifies the following TupleData message as an old tuple. This field is present if the table in which the delete happened has REPLICA IDENTITY set to FULL.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003cspan class=\"term\"\u003eTupleData\u003c/span\u003e\u003c/dt\u003e\n\u003cdd\u003e\n\u003cp\u003eTupleData message part representing the contents of the old tuple or primary key, depending on the previous field.\u003c/p\u003e\n\u003c/dd\u003e\n\u003c/dl\u003e\n\u003c/div\u003e\n\u003cp\u003eThe Delete message may contain either a 'K' message part or an 'O' message part, but never both of them.\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e","related":[{"label":"Streaming replication protocol","url":"/docs/18/protocol-replication.html"},{"label":"Logical Decoding Plugins","url":"/wiki/decode/?v=18"}],"sections":[{"paragraphs":["This section describes the detailed format of each logical replication message. These messages are either returned by the replication slot SQL interface or are sent by a walsender. In the case of a walsender, they are encapsulated inside replication protocol WAL messages as described in Section 54.4 , and generally obey the same message flow as physical replication. The following messages (Stream Start, Stream Stop, Stream Commit, and Stream Abort) are available since protocol version 2. The following messages (Begin Prepare, Prepare, Commit Prepared, Rollback Prepared, Stream Prepare) are available since protocol version 3. The following message parts are shared by the above messages."],"title":"Protocol context"}],"tables":[{"columns":[{"key":"c0","label":"Position"},{"key":"c1","label":"Format"},{"key":"c2","label":"Meaning"}],"key":"fields","rows":[{"c0":"1","c1":"Byte1('D')","c2":"Identifies the message as a delete message."},{"c0":"2","c1":"Int32 (TransactionId)","c2":"Xid of the transaction (only present for streamed transactions). This field is available since protocol version 2."},{"c0":"3","c1":"Int32 (Oid)","c2":"OID of the relation corresponding to the ID in the relation message."},{"c0":"4","c1":"Byte1('K')","c2":"Identifies the following TupleData submessage as a key. This field is present if the table in which the delete has happened uses an index as REPLICA IDENTITY."},{"c0":"5","c1":"Byte1('O')","c2":"Identifies the following TupleData message as an old tuple. This field is present if the table in which the delete happened has REPLICA IDENTITY set to FULL."},{"c0":"6","c1":"TupleData","c2":"TupleData message part representing the contents of the old tuple or primary key, depending on the previous field."}],"title":"Fields in documented order"}]}},"RequestedLocale":"en","Fallback":false,"Versions":["10","11","12","13","14","15","16","17","18","19","20"],"Locales":["en","zh-Hans"],"Signatures":null,"Spellings":null,"SQLState":null,"Evidence":null}