# 两套连接器元数据协议

/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数据库列表，也不是任意结构化来源的另一条别名。

成功列出目标不证明目标表结构可写、字段已映射或导出任务完成。数据库地址和凭据来自连接器配置，不在这两个请求中重新提交。
