最后于 更新
MySQL Schema Change 同步
MySQL Schema Change 同步用于在持续导入期间,将上游 MySQL 表的列结构变更自动应用到 Doris 目标表。该能力仅适用于 MySQL CDC 自动建表同步,不适用于 MySQL CDC SQL 映射同步。
提示
MySQL Schema Change 同步自 Doris 4.1.4 起支持。
支持的 Schema Change
| MySQL 操作 | Doris 行为 |
|---|---|
ADD COLUMN | 新增同名列,类型遵循 MySQL 数据类型映射,并复制列注释。不复制 DEFAULT 和 NOT NULL 约束,也不回填历史数据;后续数据使用 MySQL 写入 Binlog 的实际值。 |
DROP COLUMN | 删除同名列。 |
注意事项
- 如果新增列已存在或待删除列不存在,Doris 会跳过对应操作,避免作业因重试失败。
FIRST和AFTER指定的列位置不会同步到 Doris。新增列会追加到 Doris 表的现有列之后。CHANGE COLUMN、MODIFY COLUMN、RENAME COLUMN、DEFAULT 变更以及NULL/NOT NULL约束变更均不会自动同步。执行这些操作前,需要暂停持续导入作业并手动修改 Doris 目标表,确认两端结构兼容后再恢复作业。- 主键、索引、分区、表名以及其他表级结构变更不会自动同步。
- 可以通过 Job 属性
schema_change_enabled(默认true,自 4.1.4 版本起支持)关闭 Schema Change 自动同步。cdc_stream()表函数(SQL 映射同步)会强制把该属性设为false。