Skip to content

docs: note that replacement MVs must keep the same output schema#37722

Open
claude[bot] wants to merge 5 commits into
mainfrom
docs/replacement-mv-schema-note
Open

docs: note that replacement MVs must keep the same output schema#37722
claude[bot] wants to merge 5 commits into
mainfrom
docs/replacement-mv-schema-note

Conversation

@claude

@claude claude Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Requested by Nate Stewart, Pranshu Maheshwari · Slack thread

Motivation

A customer hit the error replacement schema differs from target schema when
adding new output fields to a materialized view via CREATE REPLACEMENT MATERIALIZED VIEW. The constraint that a replacement must have the identical
output 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 replacement
materialized 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

@maheshwarip
maheshwarip marked this pull request as ready for review July 17, 2026 19:37
@maheshwarip
maheshwarip requested a review from a team as a code owner July 17, 2026 19:37
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@maheshwarip
maheshwarip enabled auto-merge (squash) July 17, 2026 19:41
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 >}}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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)?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I intentionally added the repetition! But yes maybe just moving the bullet points up will help

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants