Skip to content

Source Versioning docs for MySQL#36164

Open
patrickwwbutler wants to merge 5 commits into
MaterializeInc:mainfrom
patrickwwbutler:patrick/mysql-sv-docs-2
Open

Source Versioning docs for MySQL#36164
patrickwwbutler wants to merge 5 commits into
MaterializeInc:mainfrom
patrickwwbutler:patrick/mysql-sv-docs-2

Conversation

@patrickwwbutler
Copy link
Copy Markdown
Contributor

@patrickwwbutler patrickwwbutler commented Apr 20, 2026

Adds docs outlining how to use the new CREATE TABLE FROM SOURCE syntax for MySQL sources to enable source versioning, and re-adds the source-versioning.md mysql doc that was previously reverted

@patrickwwbutler patrickwwbutler requested a review from a team April 21, 2026 16:06
@patrickwwbutler patrickwwbutler marked this pull request as ready for review April 21, 2026 16:06
@patrickwwbutler patrickwwbutler requested a review from a team as a code owner April 21, 2026 16:06
Copy link
Copy Markdown
Member

@bosconi bosconi left a comment

Choose a reason for hiding this comment

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

Here's what /mz-doc-edit came up with on its first time out of the garage.

Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
Comment thread doc/user/content/sql/create-source/mysql-v2.md
@patrickwwbutler patrickwwbutler marked this pull request as draft April 23, 2026 14:12
@patrickwwbutler patrickwwbutler changed the title Create Source v2 (new syntax) docs for MySQL Source Versioning docs for MySQL May 11, 2026
@patrickwwbutler patrickwwbutler marked this pull request as ready for review May 11, 2026 23:48
patrickwwbutler and others added 5 commits May 11, 2026 19:50
Co-authored-by: Jon Currey <bosconi@users.noreply.github.com>
Co-authored-by: Jon Currey <bosconi@users.noreply.github.com>
…nges

Adds a guide covering how to handle upstream schema changes (adding and
dropping columns) using CREATE TABLE FROM SOURCE with EXCLUDE COLUMNS,
and documents that binlog_row_metadata=FULL is required for that syntax.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@patrickwwbutler patrickwwbutler force-pushed the patrick/mysql-sv-docs-2 branch from d10ec00 to fca12b9 Compare May 11, 2026 23:51
Copy link
Copy Markdown
Contributor

@martykulma martykulma left a comment

Choose a reason for hiding this comment

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

I left some comments I think we should address, but otherwise LGTM. @kay-kim should be the final arbiter

## Prerequisites

{{% create-source/intro %}}
Materialize supports MySQL (5.7+) as a real-time data source. To connect to a
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.

Supported version should be 8.0.1?


{{% create-source/intro %}}
Materialize supports MySQL (5.7+) as a real-time data source. To connect to a
MySQL database, you first need to tweak its configuration to enable
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.

Should this go into doc/user/layouts/shortcodes/mysql-direct/ingesting-data/mysql-configs.html instead? I'm not sure how we disambiguate settings for new syntax vs. old, probably need input from @kay-kim


```sql
SET GLOBAL binlog_row_metadata = FULL;
```
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.

Does this SET persist it, if not, may want to redirect them to the parameter config?

Copy link
Copy Markdown
Contributor

@kay-kim kay-kim left a comment

Choose a reason for hiding this comment

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

Hi .. haven't reviewed yet. Will do so next week ... but, from the discussions in slack, will it not be public preview? cc: @maheshwarip

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.

4 participants