doc: Add a user documentation section for replica identity - #8
Merged
Conversation
The information about replica identity was spread over the ALTER TABLE reference page and a short subsection of the publication documentation, which left several user-visible aspects undocumented, for example how the subscriber searches for the row to modify, what a replica identity costs, and that ALTER TABLE ... REPLICA IDENTITY does not recurse to partitions. Add a dedicated "Replica Identity" section to the logical replication chapter, describing the available modes and what each of them writes to WAL, how to set and examine the replica identity, the requirements on the publisher and on the subscriber, the handling of partitioned tables, and the trade-offs of REPLICA IDENTITY FULL. The previous subsection in the publication documentation is replaced by a reference to the new section, and ALTER TABLE ... REPLICA IDENTITY now points to it as well. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KhWjMve4rzoc4qyCuhSvgy
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The information about replica identity was spread over the ALTER TABLE
reference page and a short subsection of the publication documentation,
which left several user-visible aspects undocumented, for example how the
subscriber searches for the row to modify, what a replica identity costs,
and that ALTER TABLE ... REPLICA IDENTITY does not recurse to partitions.
Add a dedicated "Replica Identity" section to the logical replication
chapter, describing the available modes and what each of them writes to
WAL, how to set and examine the replica identity, the requirements on the
publisher and on the subscriber, the handling of partitioned tables, and
the trade-offs of REPLICA IDENTITY FULL. The previous subsection in the
publication documentation is replaced by a reference to the new section,
and ALTER TABLE ... REPLICA IDENTITY now points to it as well.
Co-Authored-By: Claude Opus 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01KhWjMve4rzoc4qyCuhSvgy