docs: note that replacement MVs must keep the same output schema#37722
Open
claude[bot] wants to merge 5 commits into
Open
docs: note that replacement MVs must keep the same output schema#37722claude[bot] wants to merge 5 commits into
claude[bot] wants to merge 5 commits into
Conversation
maheshwarip
marked this pull request as ready for review
July 17, 2026 19:37
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
maheshwarip
enabled auto-merge (squash)
July 17, 2026 19:41
kay-kim
reviewed
Jul 23, 2026
| non-breaking changes such as adding a new column. Replacing a materialized | ||
| view with a different output schema fails with the error `replacement schema | ||
| differs from target schema`. | ||
| {{< /note >}} |
Contributor
There was a problem hiding this comment.
So ... we already mention in line 244 ... and I don't mind the repetition ... but is it then, that we just want to move up the first two bullet points up here (and include the must)?
Contributor
There was a problem hiding this comment.
I intentionally added the repetition! But yes maybe just moving the bullet points up will help
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.
Requested by Nate Stewart, Pranshu Maheshwari · Slack thread
Motivation
A customer hit the error
replacement schema differs from target schemawhenadding new output fields to a materialized view via
CREATE REPLACEMENT MATERIALIZED VIEW. The constraint that a replacement must have the identicaloutput schema was documented only implicitly on the replace-materialized-view
page, so this makes it prominent.
Description
Before: Step 3 of the replace-materialized-view page did not call out that
the replacement must have the same output schema as the view it replaces.
After: Step 3 now includes a
{{< note >}}stating that a replacementmaterialized view must keep the same output schema (column names, types, order,
nullability, and keys), that schema changes are not supported including
non-breaking changes such as adding a new column, and that a mismatch fails with
the error
replacement schema differs from target schema.The note is added in the Step 3 numbered list and matches the page's existing
note style.
Verification
Docs-only change. Reviewed the rendered structure to confirm the two note
blocks are well-formed and the following numbered list item still renders
correctly.
Generated by Claude Code