ksqlDB生成含connect.name的AVRO schema后自动移除该元素的原因

关于connect.name字段在v2 Schema中消失的原因 #

• ksqlDB创建流时生成的v1 Schema包含"connect.name": "my.namespace"，是因为ksqlDB内部默认会添加这个Kafka Connect相关属性，用于兼容连接器的命名空间映射逻辑——哪怕你没配置连接器，初始Schema也会带上该字段。
• 当ksqlDB自动生成v2 Schema时，会检测到当前无连接器配置，判定connect.name属于非必要冗余元数据，因此自动将其移除。这是ksqlDB针对无连接器场景的优化行为，目的是精简Schema结构。

关于doc字段被自动移除的原因 #

• 这确实和Confluent Schema Registry的默认配置直接相关。Schema Registry默认开启配置项avro.remove.non.namespace.metadata，其默认值为true。
• 该配置的作用是清理AVRO Schema中不属于核心定义的元数据字段，doc、connect.name这类可选注解或非标准元数据都在清理范围内。只要保持默认配置，这些非必填元数据就会被自动从注册的Schema中移除。

内容的提问来源于stack exchange，提问作者kopaka