文档中心
搜索
Ask AI
全部文档
文档中心开发者中心API 文档数据表

数据表

本文档说明 DataTable 系列组件对外开放的常用接口，适用于通过平台数据表能力完成配置表、日志表、映射表和中间表的读取与写入。

说明：DataTable 系列包含多个后端服务（data-table-gauss-server1-0、data-table-kingbase-server1-0、data-table-clickhouse-server1-0、data-table-deepengine-server1-0 等），但对外接口路径统一。本文档以 data-table-deepmodel-server1-0 为例展示完整 URL。

表数据读取

查询数据表记录

用于按条件读取 DeepModel、MySQL 或 ClickHouse 数据表中的业务数据，适合读取映射表、日志表、配置表和中间结果表。

请求

项目

值

HTTP Method

POST

Path

https://xxxx.com/deepfos-server/data-table-deepmodel-server1-0/datatable-using-view/data

Request Body 字段

字段名

类型

必填

说明

elementName

String

是

数据表名称

path

String

否

数据表所在路径，与 folderId 二选一

folderId

String

否

数据表所在目录 ID，与 path 二选一

pageNum

Integer

否

页码

showNum

Integer

否

每页条数

orderColumn

String

否

排序字段

sortDesc

Boolean

否

是否降序

Request Body 示例

Copy
{
  "elementName": "B0305",
  "path": "/Application/00_JJHotel/05_DATA_DeepModel/DM01/",
  "pageNum": 1,
  "showNum": 100,
  "orderColumn": "name",
  "sortDesc": false
}

响应

响应体字段

字段名

类型

说明

elementName

String

数据表名称

count

Integer

总记录数

dataList

Array

查询结果

columnName

Array

列名列表

description

String

数据表描述

actualTableName

String

实际表名

allowSQLQuery

Boolean

是否允许 SQL 查询

响应示例

Copy
{
  "elementName": "B0305",
  "count": 2,
  "dataList": [
    {
      "name": "E0101",
      "description_zh_cn": "上海主体",
      "is_base": "True"
    },
    {
      "name": "E0102",
      "description_zh_cn": "杭州主体",
      "is_base": "True"
    }
  ],
  "columnName": ["name", "description_zh_cn", "is_base"],
  "description": "实体映射表",
  "actualTableName": "B0305_20250101",
  "allowSQLQuery": true
}

自定义 SQL 查询

用于执行自定义 SQL 查询数据表数据，支持复杂条件过滤和多表联合查询。

请求

项目

值

HTTP Method

POST

Path

https://xxxx.com/deepfos-server/data-table-deepmodel-server1-0/datatable-using-view/customizesql

Request Body 字段

字段名

类型

必填

说明

elementName

String

是

数据表名称

path

String

否

数据表所在路径，与 folderId 二选一

folderId

String

否

数据表所在目录 ID，与 path 二选一

sql

String

是

自定义 SQL 语句

Request Body 示例

Copy
{
  "elementName": "B0305",
  "path": "/Application/00_JJHotel/05_DATA_DeepModel/DM01/",
  "sql": "SELECT name, description_zh_cn FROM ${B0305} WHERE is_base = 'True' ORDER BY name"
}

响应

响应体字段

字段名

类型

说明

code

Integer

响应码

message

String

响应消息

data

Object

查询结果

data.dataList

Array

数据列表

data.columnName

Array

列名列表

响应示例

Copy
{
  "code": 0,
  "message": "操作成功！",
  "data": {
    "dataList": [
      {
        "name": "E0101",
        "description_zh_cn": "上海主体"
      },
      {
        "name": "E0102",
        "description_zh_cn": "杭州主体"
      }
    ],
    "columnName": ["name", "description_zh_cn"]
  }
}

获取数据表元素信息

用于获取数据表的元数据信息，包括表结构、字段列表、索引信息等。

请求

项目

值

HTTP Method

POST

Path

https://xxxx.com/deepfos-server/data-table-deepmodel-server1-0/datatable/table-info-field

Request Body 字段

请求体为数组，每个元素包含：

字段名

类型

必填

说明

elementName

String

是

数据表名称

elementType

String

否

元素类型

path

String

否

数据表所在路径，与 folderId 二选一

folderId

String

否

数据表所在目录 ID，与 path 二选一

moduleId

String

否

模块 ID

Request Body 示例

Copy
[
  {
    "elementName": "B0305",
    "elementType": "DAT_DEEPMODEL",
    "path": "/Application/00_JJHotel/05_DATA_DeepModel/DM01/"
  }
]

响应

返回数据表的完整元数据信息，包括表基本信息、字段列表、索引信息等。

表数据写入

批量写入数据表

用于将结构化表数据批量写入数据表，适合接口日志记录、差异数据留痕、映射表补录和中间表落地。

请求

项目

值

HTTP Method

POST

Path

https://xxxx.com/deepfos-server/data-table-deepmodel-server1-0/datatable/insert

Request Body 字段

字段名

类型

必填

说明

elementName

String

是

数据表名称

path

String

否

数据表所在路径，与 folderId 二选一

folderId

String

否

数据表所在目录 ID，与 path 二选一

columnValueList

Array

是

待写入的数据记录

updatecol

Array

否

冲突时更新的字段列表

conflictTarget

Array

否

冲突判断字段

Request Body 示例

Copy
{
  "elementName": "MDM_Update_Entity_T",
  "path": "/Application/98_Interfaces_manage/02_Interface_Tables/MDM_Interface_Data_Table/",
  "columnValueList": [
    {
      "name": "E0101",
      "description_zh_cn": "上海主体",
      "parent_name": "JJGroup",
      "ud3": "",
      "update_time": "2026-03-29 10:00:00"
    },
    {
      "name": "E0102",
      "description_zh_cn": "杭州主体",
      "parent_name": "JJGroup",
      "ud3": "",
      "update_time": "2026-03-29 10:00:00"
    }
  ],
  "updatecol": ["description_zh_cn", "parent_name", "ud3"],
  "conflictTarget": ["name"]
}

响应

响应体字段

字段名

类型

说明

code

Integer

响应码

message

String

响应消息

status

Boolean

操作状态

data

Boolean

写入结果

响应示例

Copy
{
  "code": 0,
  "message": "success",
  "status": true,
  "data": true
}

表数据更新

更新数据表记录

用于根据条件更新数据表中的记录，适合维护映射表、同步主数据和刷新配置表。

请求

项目

值

HTTP Method

POST

Path

https://xxxx.com/deepfos-server/data-table-deepmodel-server1-0/datatable/update-data

Request Body 字段

字段名

类型

必填

说明

elementName

String

是

数据表名称

path

String

否

数据表所在路径，与 folderId 二选一

folderId

String

否

数据表所在目录 ID，与 path 二选一

setList

Array

是

更新字段列表

whereList

Array

是

筛选条件列表

Request Body 示例

Copy
{
  "elementName": "B0305",
  "path": "/Application/00_JJHotel/05_DATA_DeepModel/DM01/",
  "setList": [
    {
      "columnName": "description_zh_cn",
      "columnValue": "上海主体（更新）"
    }
  ],
  "whereList": [
    {
      "columnName": "name",
      "columnValue": "E0101"
    }
  ]
}

响应

响应示例

Copy
{
  "code": 0,
  "message": "success",
  "status": true,
  "data": true
}

表数据删除

删除数据表记录

用于根据条件删除数据表中的记录。

请求

项目

值

HTTP Method

POST

Path

https://xxxx.com/deepfos-server/data-table-deepmodel-server1-0/datatable/delete-data

Request Body 字段

字段名

类型

必填

说明

elementName

String

是

数据表名称

path

String

否

数据表所在路径，与 folderId 二选一

folderId

String

否

数据表所在目录 ID，与 path 二选一

columnList

Array

是

删除条件列表

Request Body 示例

Copy
{
  "elementName": "B0305",
  "path": "/Application/00_JJHotel/05_DATA_DeepModel/DM01/",
  "columnList": [
    {
      "columnName": "name",
      "columnValue": "E0101"
    }
  ]
}

响应

响应示例

Copy
{
  "code": 0,
  "message": "success",
  "status": true,
  "data": true
}

自定义 SQL 执行

执行自定义 SQL（后端调用）

用于执行自定义 SQL 语句，支持增删改查和多表联合查询。

请求

项目

值

HTTP Method

POST

Path

https://xxxx.com/deepfos-server/data-table-deepmodel-server1-0/datatable/custom-sql

Request Body 字段

字段名

类型

必填

说明

sql

String

是

自定义 SQL 语句

Request Body 示例

Copy
{
  "sql": "SELECT name, description_zh_cn FROM B0305_20250101 WHERE is_base = 'True'"
}

响应

响应体字段

字段名

类型

说明

code

Integer

响应码

message

String

响应消息

status

Boolean

操作状态

data

Object

执行结果

data.dataList

Array

数据列表

data.columnList

Array

列名列表

响应示例

Copy
{
  "code": 0,
  "message": "success",
  "status": true,
  "data": {
    "dataList": [
      {
        "name": "E0101",
        "description_zh_cn": "上海主体"
      }
    ],
    "columnList": ["name", "description_zh_cn"]
  }
}
上一篇：财务模型
下一篇：Python SDK 文档概述
本页目录

回到顶部

咨询热线

400-821-9199

我们使用 ChatGPT，基于文档中心的内容以及对话上下文回答您的问题。

ctrl+Enter to send

© 2022 先胜云. All Rights Reserved.