连接器接入 ​

连接器把数据源能力转成平台统一接口。开始前需要数据所有者批准、网络路径、最小权限凭据、数据分类、预期负载和源系统联系人。

接入步骤 ​

1. 选择 JDBC、HTTP、CDC 或新 SPI 实现，并声明连接器版本。
2. 声明读取、下推、分页、批量、写入、幂等、CDC 和证据能力。
3. 在密钥系统中绑定凭据引用，不把密钥写入配置或模型。
4. 执行连通性、权限、Schema 和能力探测。
5. 配置超时、并发、限流、网络区和熔断。
6. 建立本体数据绑定，并验证类型转换、主键和敏感字段。
7. 运行契约、性能、故障和数据质量测试后启用。

写入要求 ​

优先调用源业务 API。连接器必须说明幂等语义、业务流水号、成功条件、结果查询和可用补偿。只支持数据库写入时，需要数据所有者明确授权，并证明不会绕过业务规则。

CDC 要求 ​

保存快照和增量位点，处理重复、乱序、Schema 漂移和断点续传。删除、权限消失和连接器过滤应使用不同事件语义。重放不能重复产生不可逆下游副作用。

上线门槛 ​

能力声明与真实行为一致；凭据可轮换；错误可分类；源端限流得到遵守；监控和责任人明确；停用和回滚不会让 Runtime 继续选择不可用路径。