查询来源数据库表¶

分页查询当前身份可用于创建发布的来源数据库表。

GET https://api.moi.matrixorigin.cn/v5/data-share/source-databases/{source_database_id}/tables

调用前准备¶

先查询数据库列表取得来源数据库 ID。准备可访问目标工作区的个人访问令牌、目标工作区 ID 和来源数据库 ID。

请求参数¶

输入示例

curl "https://api.moi.matrixorigin.cn/v5/data-share/source-databases/$SOURCE_DATABASE_ID/tables?page=1&page_size=20" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

路径参数

字段	类型	是否必填	说明
`source_database_id`	string	是	来源数据库 ID。

查询参数

字段	类型	是否必填	说明
`page`	integer	否	页码。
`page_size`	integer	否	每页数量。

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "list": [
      {
        "id": "101",
        "name": "orders"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20
  }
}

字段说明

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	object	响应数据。
`data.list`	object（对象数组）	当前页可发布的表。
`data.total`	integer	匹配表总数。
`data.page`	integer	当前页码。
`data.page_size`	integer	每页数量。
`data.list[].id`	string	MatrixOne 物理表的 uint64 rel_id，按十进制字符串返回。与 Catalog table_id 不同。
`data.list[].name`	string	表名称。

错误响应¶

响应示例

{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`msg`	string	错误说明。
`data`	null	错误时为空。

常见 HTTP 错误¶

HTTP 状态码	错误代码	常见原因	建议操作
400	`ErrWorkspaceRequired`、`ErrParamInvalid`	请求字段、工作区或操作前置条件无效。	修正参数后再提交。
403	`ErrPermissionDenied`	当前身份或有效角色无执行该操作的权限。	使用有权限的身份，或联系管理员授权。
404	`ErrSourceNotFound`	目标对象或所需引用未找到。	核对对象标识、所属工作区和当前状态。
500	`ErrServer`	内部处理失败；写操作可能已有部分效果。	保留请求和追踪信息，先核对当前结果。
503	`ErrServiceUnavailable`	业务、运行时或授权依赖暂不可用。	恢复依赖后先核对已有结果，不自动重复写入。

最后更新于 2026 年 10 月 19 日