连接器请求与结果

这六个入口使用顶层路径和X-Workspace-ID。产品身份与运行期任务身份的正式边界分别由路由装配处理;示例使用普通PAT,不把任务证明当任意数据访问权限。

调用前准备

BASE_URL包含同环境产品前缀,MOI_KEY为产品凭据,WORKSPACE_ID为可访问工作区。请求中的connector_id来自已保存连接器;database、schema、table按上一次实际元数据结果填写。示例连接器和结果为固定占位值。

/db读取需要connector.use,服务还读取连接器配置并调用Worker;/mo目标读取另需export_task.create。没有分页或总数参数,不构造下一页链接。

成功结果

成功使用字符串code=OK、msg=OK和data对象。databases/schemas/tables均为字符串数组;旧数据库/schema结果的nil切片可返回null,不把它当接口失败或全系统没有对象。表列表从transport对象投影名称,未保留全部原始定位信息。

columns字段

类型

说明

name

string

来源字段名。

data_type

string

来源类型。

mapped_type

string

映射类型。

is_primary_key

boolean

是否主键。

is_nullable

boolean

是否允许空值。

is_auto_incr

boolean

是否自增,false时HTTP可省略。

当前专用SDK保留这些字段的类型语义;重新编码JSON时默认false可能省略,不把缺失看成true。该结果不是现代schema_snapshot或目标字段兼容完整报告。

错误及空结果

旧/db handler在部分参数或操作失败时仍写HTTP200和非OK业务code;SDK正常构造后还可能在响应解码阶段返回业务错误。必须同时检查HTTP、code和实际结果。身份/权限/依赖错误按各自映射,不宣称所有错误均HTTP200。

MatrixOne入口使用公共service错误适配,不复用旧/db固定错误状态。空结果仅表示该次当前权限/连接器/源目标的读取结果,不能代替来源连通、引擎兼容性或生产开放范围验证。

最后更新于