两套连接器元数据协议¶
/connectors/db与/connectors/structured/v1同时注册,且当前SDK分别调用。路径较早不等于已经弃用;仅换地址不能完成协议迁移。
项目 |
/connectors/db |
/connectors/structured/v1 |
|---|---|---|
来源类型 |
从已保存connector_id推导。 |
请求携带source_type,并与连接器类型核对。 |
数据库/schema列表 |
databases或schemas中的字符串数组。 |
name/display_name对象数组及endpoint_results。 |
表/对象列表 |
tables中的表名字符串。 |
带database/schema/table/collection/object_kind的objects。 |
字段结构 |
columns六字段数组。 |
schema_snapshot、端点结果及适用的映射/哈希对象。 |
使用条件 |
所查旧service核对active、Worker类型映射和配置;不自动套现代载入用途检查。 |
另核对来源类型、载入用途及相应能力/开关。 |
错误 |
旧handler部分参数/操作错误仍HTTP200,必须检查业务code。 |
按现代接口错误/能力协议处理,不能照搬旧状态。 |
现代接口已在现有Reference中说明;六个旧式入口仍由专用SDK/CLI使用,应补兼容合同/对应关系,不能按六条路由另建六项现代来源功能。没有源码弃用声明时不写“已废弃”或“将被删除”。
MatrixOne目标协议¶
/connectors/mo/database/list和/table/list使用已保存MatrixOne连接器的外部目标配置,执行真实目标元数据读取。权限包含export_task.create和connector.use;它不是当前工作区Catalog数据库列表,也不是任意结构化来源的另一条别名。
成功列出目标不证明目标表结构可写、字段已映射或导出任务完成。数据库地址和凭据来自连接器配置,不在这两个请求中重新提交。