MaterializeMySQL 引擎在 ClickHouse 24.8+ 中已被彻底移除，创建失败主因是版本不匹配（22.8 起弃用、24.1 默认禁用、24.8 删除），且依赖 MySQL GTID+ROW binlog、足够权限及正确时区配置；替代方案按场景推荐 go-mysql、SeaTunnel 或 Flink CDC。
MaterializeMySQL 引擎不是“开箱即用”的实时同步方案，它依赖 MySQL 的主从复制机制，且在 ClickHouse 24.8+ 版本中已被正式弃用并移除。如果你正在用较新版本（如 24.1.8 或更高），直接执行 CREATE DATABASE ... ENGINE = MaterializeMySQL 会报错：Unknown database engine MaterializeMySQL。
为什么 MaterializeMySQL 创建失败或查不到表
最常见原因是版本不匹配或配置未生效：
-
MaterializeMySQL自 ClickHouse 22.8 起标记为 deprecated，24.1 开始默认禁用，24.8+ 彻底删除 —— 即使你设置了allow_experimental_database_materialized_mysql = 1，也无效 - MySQL 端未启用 GTID + ROW 格式 binlog：缺少
gtid_mode=ON、enforce_gtid_consistency=ON、binlog_format=ROW中任意一项，MaterializeMySQL启动时会静默失败或卡在初始化状态 - MySQL 账户权限不足：需要
REPLICATION SLAVE、REPLICATION CLIENT、SELECT权限，仅SELECT不够 - ClickHouse 用户未被授予
CREATE DATABASE权限（尤其在集群模式下）
MaterializeMySQL 同步后表里多出 _sign 和 _version 字段怎么处理
这是引擎自动添加的系统字段，用于实现 ReplacingMergeTree 的去重逻辑：
-
_sign：值为1（插入/更新）或-1（删除），不可写入，也不建议在业务 SQL 中显式 SELECT 它 -
_version：全局单调递增整数，作为ReplacingMergeTree的ver参数，决定合并时保留哪条记录 - 实际查询应使用
FINAL或建物化视图封装逻辑，例如：SELECT * FROM db.table FINAL WHERE _sign = 1
；但注意FINAL是低效操作，生产环境慎用 - 如果下游 BI 工具报字段不识别，需在视图层屏蔽这两个字段：
CREATE VIEW db.v_table AS SELECT col1, col2, ... FROM db.table FINAL WHERE _sign = 1
替代 MaterializeMySQL 的轻量级实时方案选哪个
当前（2026 年）推荐按场景分三档：
- 单库少量表（≤5 张）、无复杂 ETL：用
go-mysql（已维护至 v1.7.0），它直连 MySQL binlog，输出 INSERT 语句到 ClickHouse HTTP 接口，延迟稳定在 200ms 内，配置只需一个 YAML - 需字段映射/过滤/类型转换：用
SeaTunnel（v2.3.6+），支持MySQL-CDCSource +ClickHouseSink，内置 JSON/Avro 解析，可跳过 DDL 自动建表 - 高吞吐（>10w rows/sec）、多源汇聚、需 Exactly-Once：必须上
Flink CDC+ Kafka，ClickHouse 侧用clickhouse-copier或Kafka Engine表消费
注意：MySQL 表引擎（非 MaterializeMySQL）仍可用，但它只是远程查询代理，不落地、不实时、不支持 DELETE/UPDATE 同步 —— 别把它和物化混淆。
最容易被忽略的兼容性细节
即使你成功跑通 MaterializeMySQL（比如在 22.8 版本），以下三点常导致数据错乱却难以定位：
- MySQL 的
TIMESTAMP类型在 ClickHouse 中会被转成DateTime，但若 MySQL 服务时区为+08:00而 ClickHouse 配置为UTC，时间值会偏移 8 小时 —— 必须统一两边timezone设置 - MySQL 的
ENUM/SET类型无法被正确映射，MaterializeMySQL会将其转为String，但排序和比较行为与原意不符 - DDL 变更（如加列）可能触发全量重建，期间表不可读；而
ALTER TABLE ... DROP COLUMN在 MySQL 执行后，ClickHouse 对应表不会自动删字段，残留 NULL 列
