网站开发文档教学网站电话素材
1. 设计目标与工作机制
Upsert-Kafka Connector
- 核心功能：支持以 Upsert（插入/更新/删除） 模式读写 Kafka 数据，适用于需要动态更新结果的场景（如聚合统计、CDC 数据同步）。
- 数据流类型：
- 作为 Source：消费 Kafka 的 Changelog 流，每条记录表示一个更新或删除事件。若 Key 不存在则为插入（INSERT），存在则为更新（UPDATE），Value 为空则为删除（DELETE）。
- 作为 Sink：将 Flink 的 Retract 流 或 Changelog 流 写入 Kafka。INSERT/UPDATE 操作写入完整 Value，DELETE 操作写入 Value 为空的墓碑消息。
- 主键约束：必须定义 PRIMARY KEY，Flink 根据主键值对数据进行分区，确保同一主键的更新/删除消息落在同一 Kafka 分区，保证顺序处理。
通用 Kafka Connector
- 核心功能：仅支持 Append-only 流，即只能追加数据，无法处理更新或删除操作。
- 数据流类型：适用于一次性写入的日志型数据（如传感器数据、日志流），无法表达数据变更语义。
- 主键约束：无需定义主键，数据按业务逻辑或随机分区写入 Kafka。
2. 数据更新与删除的实现
Upsert-Kafka
- 更新逻辑：
- 通过主键判断数据是否存在：存在则覆盖旧值（UPDATE），不存在则插入（INSERT）。
- 删除操作通过发送 Value 为空的 Kafka 消息实现（逻辑删除）。
- 一致性保障：启用 Checkpoint 时支持 至少一次语义，但通过主键的幂等性保证最终一致性（同一主键的多次更新仅最后一次生效）。
通用 Kafka Connector
- 更新限制：无法直接更新或删除已写入 Kafka 的数据。若需实现类似功能，需业务层自行处理（如通过外部状态存储或流处理逻辑生成全量覆盖数据）。
3. 配置与数据格式
Upsert-Kafka
- 序列化要求：
- 必须指定 Key 和 Value 的序列化格式（如 JSON、Avro），且 Key 对应主键字段。
- 支持配置
value.fields-include控制 Value 是否包含主键字段，或通过key.fields-prefix避免字段命名冲突。
- 示例配置：
CREATE TABLE upsert_table (user_id STRING,pv BIGINT,PRIMARY KEY (user_id) NOT ENFORCED ) WITH ('connector' = 'upsert-kafka','key.format' = 'json','value.format' = 'json',... );
通用 Kafka Connector
- 序列化要求：仅需指定 Value 的序列化格式，Key 通常不承载业务语义（如随机生成或为空）。
- 示例配置：
CREATE TABLE append_table (log STRING ) WITH ('connector' = 'kafka','value.format' = 'raw',... );
4. 适用场景
Upsert-Kafka
- 动态聚合统计：如实时计算用户访问量（PV/UV），结果需随新数据不断更新。
- CDC 数据同步：将数据库的变更日志（如 MySQL Binlog）写入 Kafka，支持插入、更新、删除操作。
- 幂等写入：避免因故障重启导致的重复数据问题。
通用 Kafka Connector
- 日志采集：写入无需更新的原始数据流（如用户行为日志）。
- 一次性事件：如订单创建、消息通知等仅需追加的场景。
5. 性能与分区策略
- Upsert-Kafka：根据主键分区，确保同一主键的更新有序，适合高频更新场景，但可能因主键分布不均导致数据倾斜。
- 通用 Kafka Connector：分区策略灵活（如轮询、Hash），适合均匀分布的数据写入。
总结对比表
| 特性 | Upsert-Kafka | 通用 Kafka Connector |
|---|---|---|
| 主键要求 | 必须定义 PRIMARY KEY | 无需主键 |
| 数据变更支持 | 支持 INSERT/UPDATE/DELETE | 仅支持 INSERT（Append-only） |
| 序列化配置 | 需指定 Key 和 Value 格式 | 仅需指定 Value 格式 |
| 适用场景 | 动态聚合、CDC 同步、幂等写入 | 日志采集、一次性事件 |
| 分区策略 | 按主键分区 | 按业务字段或随机分区 |
| 典型错误 | 未定义主键或格式不匹配导致报错 | 无法处理更新操作 |
通过上述对比可以看出，Upsert-Kafka Connector 更适合需要处理数据变更的场景，而 通用 Kafka Connector 更适用于无需更新的数据流。实际选型需结合业务需求和数据特征。