diff --git a/doc/src/sgml/logical-replication.sgml b/doc/src/sgml/logical-replication.sgml index 8290cd1a083..7cc5f4b18d6 100644 --- a/doc/src/sgml/logical-replication.sgml +++ b/doc/src/sgml/logical-replication.sgml @@ -124,35 +124,6 @@ TRUNCATE. See ). - - A published table must have a replica identity configured in - order to be able to replicate UPDATE - and DELETE operations, so that appropriate rows to - update or delete can be identified on the subscriber side. By default, - this is the primary key, if there is one. Another unique index (with - certain additional requirements) can also be set to be the replica - identity. If the table does not have any suitable key, then it can be set - to replica identity FULL, which means the entire row becomes - the key. When replica identity FULL is specified, - indexes can be used on the subscriber side for searching the rows. Candidate - indexes must be btree or hash, non-partial, and the leftmost index field must - be a column (not an expression) that references the published table column. - These restrictions on the non-unique index properties adhere to some of the - restrictions that are enforced for primary keys. If there are no such - suitable indexes, the search on the subscriber side can be very inefficient, - therefore replica identity FULL should only be used as a - fallback if no other solution is possible. If a replica identity other - than FULL is set on the publisher side, a replica identity - comprising the same or fewer columns must also be set on the subscriber - side. See for details on - how to set the replica identity. If a table without a replica identity is - added to a publication that replicates UPDATE - or DELETE operations then - subsequent UPDATE or DELETE - operations will cause an error on the publisher. INSERT - operations can proceed regardless of any replica identity. - - Every publication can have multiple subscribers. @@ -169,6 +140,59 @@ transactional, so the table will start or stop replicating at the correct snapshot once the transaction has committed. + + + Replica Identity + + + A published table must have a replica identity + configured in order to be able to replicate UPDATE + and DELETE operations, so that appropriate rows to + update or delete can be identified on the subscriber side. + + + + By default, this is the primary key, if there is one. Another unique index + (with certain additional requirements) can also be set to be the replica + identity. If the table does not have any suitable key, then it can be set + to replica identity FULL, which means the entire row + becomes the key. When replica identity FULL is + specified, indexes can be used on the subscriber side for searching the + rows. Candidate indexes must be btree or hash, non-partial, and the + leftmost index field must be a column (not an expression) that references + the published table column. These restrictions on the non-unique index + properties adhere to some of the restrictions that are enforced for + primary keys. If there are no such suitable indexes, the search on the + subscriber side can be very inefficient, therefore replica identity + FULL should only be used as a fallback if no other + solution is possible. + + + + If a replica identity other than FULL is set on the + publisher side, a replica identity comprising the same or fewer columns + must also be set on the subscriber side. + + + + Tables with a replica identity defined as NOTHING, + DEFAULT without a primary key, or USING + INDEX with a dropped index, cannot support + UPDATE or DELETE operations when + included in a publication replicating these actions. Attempting such + operations will result in an error on the publisher. + + + + INSERT operations can proceed regardless of any replica identity. + + + + See ALTER TABLE...REPLICA IDENTITY + for details on how to set the replica identity. + + + diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml index 938450fba18..df4f5d5bbd8 100644 --- a/doc/src/sgml/ref/alter_table.sgml +++ b/doc/src/sgml/ref/alter_table.sgml @@ -927,8 +927,9 @@ WITH ( MODULUS numeric_literal, REM DEFAULT - Records the old values of the columns of the primary key, if any. + Records the old values of the columns of the primary key. This is the default for non-system tables. + When there is no primary key, the behavior is the same as NOTHING.