Skip to content

Conversation

@ilidemi
Copy link
Member

@ilidemi ilidemi commented Jan 13, 2026

Summary

Mention schema changes in ClickPipes are not supported on MySQL 5.x

Checklist

@ilidemi ilidemi requested review from a team as code owners January 13, 2026 22:02
@vercel
Copy link

vercel bot commented Jan 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment Jan 13, 2026 10:12pm
3 Skipped Deployments
Project Deployment Review Updated (UTC)
clickhouse-docs-jp Ignored Ignored Jan 13, 2026 10:12pm
clickhouse-docs-ru Ignored Ignored Jan 13, 2026 10:12pm
clickhouse-docs-zh Ignored Ignored Jan 13, 2026 10:12pm

@ilidemi
Copy link
Member Author

ilidemi commented Jan 14, 2026

Waiting on internal discussions to happen before checking in.

:::note

Column exclusion is not supported for MySQL 5.7 because the `binlog_row_metadata` setting wasn't yet introduced.
Column exclusion and schema changes are not supported for MySQL 5.7 because the `binlog_row_metadata` setting wasn't yet introduced.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Column exclusion and schema changes are not supported for MySQL 5.7 because the `binlog_row_metadata` setting wasn't yet introduced.
Column exclusion and schema changes are not supported for MySQL 5.7 and older versions. These features depend on table metadata not available in the binlog prior to [MySQL 8.0.1](https://dev.mysql.com/blog-archive/more-metadata-is-written-into-binary-log/).

| Adding a new column with a default value (`ALTER TABLE ADD COLUMN ... DEFAULT ...`) | Propagated automatically. The new column(s) will be populated for all rows replicated after the schema change, but existing rows will not show the default value without a full table refresh |
| Dropping an existing column (`ALTER TABLE DROP COLUMN ...`) | Detected, but **not** propagated. The dropped column(s) will be populated with `NULL` for all rows replicated after the schema change |

**Schema changes on MySQL 5.x are not supported**, as reliably tracking columns depends on `binlog_row_metadata` which was added in MySQL 8.0.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
**Schema changes on MySQL 5.x are not supported**, as reliably tracking columns depends on `binlog_row_metadata` which was added in MySQL 8.0.
**Schema changes are not supported for MySQL 5.7 and older versions**. Reliably tracking columns depends on on table metadata not available in the binlog prior to [MySQL 8.0.1](https://dev.mysql.com/blog-archive/more-metadata-is-written-into-binary-log/).

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.

6 participants