{"kind": "protocol", "major": "18", "item": {"slug": "logical-tupledata", "name": "TupleData (logical replication)", "name_zh": "", "category": "Logical replication formats", "summary": "Logical replication TupleData format. Number of columns.", "aliases": ["TupleData"], "content_hash": "974a4fbeddbe6325bb651301632aae5ecdeefc6529083172d6acdaf5783a1e90", "versions": {"10": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "6", "c1": "Byte n", "c2": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/10/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=10", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v10.23/postgresql-10.23.tar.bz2", "label": "10.23", "major": "10", "channel": "stable", "revision": "94a4b2528372458e5662c18d406629266667c437198160a18cdfd2c4a4d6eee9"}, "sources": [{"url": "/docs/10/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 10 English manual", "sha256": "d59789e57fb3bfca55c805338f0883d2569b3a32490546294e2b60f3d8cd6d64"}], "sections": [{"title": "Protocol context", "paragraphs": ["This section describes the detailed format of each logical replication message. These messages are returned either by the replication slot SQL interface or are sent by a walsender. In case of a walsender they are encapsulated inside the replication protocol WAL messages as described in Section 52.4 and generally obey same message flow as physical replication. The following message parts are shared by the above messages."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each column:

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, in text format. (A future release might support additional formats.) n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/10/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}]}, "comparison_hash": "6f77d3612873e3baf0cb7351d706cf0bb8d9a7c7b4b1533b34c1366f860fa3a2"}, "11": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "6", "c1": "Byte n", "c2": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/11/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=11", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v11.22/postgresql-11.22.tar.bz2", "label": "11.22", "major": "11", "channel": "stable", "revision": "2cb7c97d7a0d7278851bbc9c61f467b69c094c72b81740b751108e7892ebe1f0"}, "sources": [{"url": "/docs/11/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 11 English manual", "sha256": "398afd7945b4d61facda275c78067baa3f49d65bfd2ca840fbe3074533403b62"}], "sections": [{"title": "Protocol context", "paragraphs": ["This section describes the detailed format of each logical replication message. These messages are returned either by the replication slot SQL interface or are sent by a walsender. In case of a walsender they are encapsulated inside the replication protocol WAL messages as described in Section 53.4 and generally obey same message flow as physical replication. The following message parts are shared by the above messages."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each column:

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, in text format. (A future release might support additional formats.) n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/11/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}]}, "comparison_hash": "6f77d3612873e3baf0cb7351d706cf0bb8d9a7c7b4b1533b34c1366f860fa3a2"}, "12": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "6", "c1": "Byte n", "c2": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/12/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=12", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v12.22/postgresql-12.22.tar.bz2", "label": "12.22", "major": "12", "channel": "stable", "revision": "8df3c0474782589d3c6f374b5133b1bd14d168086edbc13c6e72e67dd4527a3b"}, "sources": [{"url": "/docs/12/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 12 English manual", "sha256": "8c2e615799c7af869e31164cdf7d82d5ec7526abfe0ec84a35c4553bc8b2e9dc"}], "sections": [{"title": "Protocol context", "paragraphs": ["This section describes the detailed format of each logical replication message. These messages are returned either by the replication slot SQL interface or are sent by a walsender. In case of a walsender they are encapsulated inside the replication protocol WAL messages as described in Section 52.4 and generally obey same message flow as physical replication. The following message parts are shared by the above messages."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each column (except generated columns):

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, in text format. (A future release might support additional formats.) n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/12/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}]}, "comparison_hash": "6f77d3612873e3baf0cb7351d706cf0bb8d9a7c7b4b1533b34c1366f860fa3a2"}, "13": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "6", "c1": "Byte n", "c2": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/13/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=13", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v13.23/postgresql-13.23.tar.bz2", "label": "13.23", "major": "13", "channel": "stable", "revision": "6ec3c82726af92b7dec873fa1cdf881eca92a4219787dfad05acb6b10e041fd6"}, "sources": [{"url": "/docs/13/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 13 English manual", "sha256": "c740d4c528ea137a87c0f9bf8ea8859fe6707c758374a12bc3c2390ac35427f1"}], "sections": [{"title": "Protocol context", "paragraphs": ["This section describes the detailed format of each logical replication message. These messages are returned either by the replication slot SQL interface or are sent by a walsender. In case of a walsender they are encapsulated inside the replication protocol WAL messages as described in Section 52.4 and generally obey same message flow as physical replication. The following message parts are shared by the above messages."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each column (except generated columns):

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, in text format. (A future release might support additional formats.) n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/13/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, in text format. (A future release might support additional formats.) n is the above length."}]}, "comparison_hash": "6f77d3612873e3baf0cb7351d706cf0bb8d9a7c7b4b1533b34c1366f860fa3a2"}, "14": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Byte1('b')", "c2": "Identifies the data as binary formatted value."}, {"c0": "6", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "7", "c1": "Byte n", "c2": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/14/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=14", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v14.24/postgresql-14.24.tar.bz2", "label": "14.24", "major": "14", "channel": "stable", "revision": "a7fa7ed3d558172355f51406097a7bd4f6b473be80f311ef7cda96bf383d8897"}, "sources": [{"url": "/docs/14/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 14 English manual", "sha256": "4d5309e6070938fb53a3380c66fb64152d7984a368c86536d69ecac5bdb42852"}], "sections": [{"title": "Protocol context", "paragraphs": ["This section describes the detailed format of each logical replication message. These messages are returned either by the replication slot SQL interface or are sent by a walsender. In case of a walsender they are encapsulated inside the replication protocol WAL messages as described in Section 53.4 and generally obey 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 message parts are shared by the above messages."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each column (except generated columns):

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('b')
\n
\n

Identifies the data as binary formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/14/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}]}, "comparison_hash": "cd3ef259b145bd3bd43cb6212efe54d716871132f92df99b0cc8d685cc43c2fd"}, "15": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Byte1('b')", "c2": "Identifies the data as binary formatted value."}, {"c0": "6", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "7", "c1": "Byte n", "c2": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/15/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=15", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v15.19/postgresql-15.19.tar.bz2", "label": "15.19", "major": "15", "channel": "stable", "revision": "e1a64a87a46b825b88c082e4518161a47aab53c45694964f8ba1df28f7859f89"}, "sources": [{"url": "/docs/15/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-TUPLEDATA", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 15 English manual", "sha256": "dce726e09e3bfedfcea89e211772f1afb48a00fd03f33fb94ce66e6d6e2938f5"}], "sections": [{"title": "Protocol context", "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 55.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."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each column (except generated columns):

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('b')
\n
\n

Identifies the data as binary formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/15/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}]}, "comparison_hash": "cd3ef259b145bd3bd43cb6212efe54d716871132f92df99b0cc8d685cc43c2fd"}, "16": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Byte1('b')", "c2": "Identifies the data as binary formatted value."}, {"c0": "6", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "7", "c1": "Byte n", "c2": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/16/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=16", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v16.15/postgresql-16.15.tar.bz2", "label": "16.15", "major": "16", "channel": "stable", "revision": "c1575341fa7bd40f5274ea465b34390f4dc64cdd0770af327005caaeb9f6b7ed"}, "sources": [{"url": "/docs/16/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-TUPLEDATA", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 16 English manual", "sha256": "23e3687e7c97c6a17a24684c30716fb7beed99c85967e828f4ee378effb5b50e"}], "sections": [{"title": "Protocol context", "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 55.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."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each column (except generated columns):

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('b')
\n
\n

Identifies the data as binary formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/16/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}]}, "comparison_hash": "cd3ef259b145bd3bd43cb6212efe54d716871132f92df99b0cc8d685cc43c2fd"}, "17": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Byte1('b')", "c2": "Identifies the data as binary formatted value."}, {"c0": "6", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "7", "c1": "Byte n", "c2": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/17/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=17", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "label": "17.11", "major": "17", "channel": "stable", "revision": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}, "sources": [{"url": "/docs/17/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-TUPLEDATA", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 17 English manual", "sha256": "438b6a09f48bd0e9d2424559a0ab950dce44a9ab6573d362362c1c8d0b375fe3"}], "sections": [{"title": "Protocol context", "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 53.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."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each column (except generated columns):

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('b')
\n
\n

Identifies the data as binary formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/17/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}]}, "comparison_hash": "cd3ef259b145bd3bd43cb6212efe54d716871132f92df99b0cc8d685cc43c2fd"}, "18": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Byte1('b')", "c2": "Identifies the data as binary formatted value."}, {"c0": "6", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "7", "c1": "Byte n", "c2": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/18/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=18", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "label": "18.6", "major": "18", "channel": "stable", "revision": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, "sources": [{"url": "/docs/18/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-TUPLEDATA", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 18 English manual", "sha256": "e976b008206820fbeb1eba226e69bb7c00af157372c3545375d1b5053c76d0ad"}], "sections": [{"title": "Protocol context", "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."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each published column:

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('b')
\n
\n

Identifies the data as binary formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/18/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}]}, "comparison_hash": "cd3ef259b145bd3bd43cb6212efe54d716871132f92df99b0cc8d685cc43c2fd"}, "19": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Byte1('b')", "c2": "Identifies the data as binary formatted value."}, {"c0": "6", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "7", "c1": "Byte n", "c2": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/19/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=19", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "label": "19beta4", "major": "19", "channel": "preview", "revision": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}, "sources": [{"url": "/docs/19/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-TUPLEDATA", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 19 English manual", "sha256": "e09479de1e9cef5a4abc9703d423b68677f7f7e0e44c1098a2d37144980fd461"}], "sections": [{"title": "Protocol context", "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."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each published column:

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('b')
\n
\n

Identifies the data as binary formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/19/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}]}, "comparison_hash": "cd3ef259b145bd3bd43cb6212efe54d716871132f92df99b0cc8d685cc43c2fd"}, "20": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Byte1('b')", "c2": "Identifies the data as binary formatted value."}, {"c0": "6", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "7", "c1": "Byte n", "c2": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/devel/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=20", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "label": "20devel", "major": "20", "channel": "devel", "revision": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41"}, "sources": [{"url": "/docs/devel/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-TUPLEDATA", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 20 English manual", "sha256": "1c5d9d7ff344de5d066562bb12e9db460a51b7713932ca201856714fa9477238"}], "sections": [{"title": "Protocol context", "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."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each published column:

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('b')
\n
\n

Identifies the data as binary formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/devel/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}]}, "comparison_hash": "cd3ef259b145bd3bd43cb6212efe54d716871132f92df99b0cc8d685cc43c2fd"}}}, "snapshot": {"facts": [{"label": "Layer", "value": "Logical replication payload; distinct from the frontend/backend message envelope"}, {"label": "First field", "value": "Int16"}], "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "tables": [{"key": "fields", "rows": [{"c0": "1", "c1": "Int16", "c2": "Number of columns."}, {"c0": "2", "c1": "Byte1('n')", "c2": "Identifies the data as NULL value."}, {"c0": "3", "c1": "Byte1('u')", "c2": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"c0": "4", "c1": "Byte1('t')", "c2": "Identifies the data as text formatted value."}, {"c0": "5", "c1": "Byte1('b')", "c2": "Identifies the data as binary formatted value."}, {"c0": "6", "c1": "Int32", "c2": "Length of the column value."}, {"c0": "7", "c1": "Byte n", "c2": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}], "title": "Fields in documented order", "columns": [{"key": "c0", "label": "Position"}, {"key": "c1", "label": "Format"}, {"key": "c2", "label": "Meaning"}]}], "related": [{"url": "/docs/18/protocol-replication.html", "label": "Streaming replication protocol"}, {"url": "/wiki/decode/?v=18", "label": "Logical Decoding Plugins"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "label": "18.6", "major": "18", "channel": "stable", "revision": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, "sources": [{"url": "/docs/18/protocol-logicalrep-message-formats.html#PROTOCOL-LOGICALREP-MESSAGE-FORMATS-TUPLEDATA", "path": "protocol-logicalrep-message-formats.html", "label": "PostgreSQL 18 English manual", "sha256": "e976b008206820fbeb1eba226e69bb7c00af157372c3545375d1b5053c76d0ad"}], "sections": [{"title": "Protocol context", "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."]}], "signature": "TupleData", "description": ["Logical replication TupleData format. Number of columns."], "manual_html": "
\n
\n
\n
Int16
\n
\n

Number of columns.

\n
\n
\n
\n

Next, one of the following submessages appears for each published column:

\n
\n
\n
Byte1('n')
\n
\n

Identifies the data as NULL value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('u')
\n
\n

Identifies unchanged TOASTed value (the actual value is not sent).

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('t')
\n
\n

Identifies the data as text formatted value.

\n
\n
\n
\n

Or

\n
\n
\n
Byte1('b')
\n
\n

Identifies the data as binary formatted value.

\n
\n
Int32
\n
\n

Length of the column value.

\n
\n
Byten
\n
\n

The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length.

\n
\n
\n
\n
", "manual_path": "/docs/18/protocol-logicalrep-message-formats.html", "comparison_data": {"layer": "logical replication", "fields": [{"format": "Int16", "description": "Number of columns."}, {"format": "Byte1('n')", "description": "Identifies the data as NULL value."}, {"format": "Byte1('u')", "description": "Identifies unchanged TOASTed value (the actual value is not sent)."}, {"format": "Byte1('t')", "description": "Identifies the data as text formatted value."}, {"format": "Byte1('b')", "description": "Identifies the data as binary formatted value."}, {"format": "Int32", "description": "Length of the column value."}, {"format": "Byte n", "description": "The value of the column, either in binary or in text format. (As specified in the preceding format byte). n is the above length."}]}, "comparison_hash": "cd3ef259b145bd3bd43cb6212efe54d716871132f92df99b0cc8d685cc43c2fd"}, "comparison": {"left": "17", "right": "18", "status": "unchanged", "diff": ""}}