1. 从第三方数据库导入数据
从第三方数据库导入数据。
请求方式:POST
请求地址:/bosfoundationservice/{appKey}/data/import
1.1. 请求参数:
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | access_token |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
Body(FORM形式)
{
"configFile":#具体映射关系配置文件(file类型)
"connect": {
"type": "MySQL", #连接类型
"ip": "192.168.1.26",
"port": "3306",
"username": "root",
"password": "root",
"database": "test"
},
"insert": true, #是否新增,非必填项,默认true
"update": true #是否更新,非必填项,默认true
}
1.2. 参数说明:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
1.3. 正确返回:
(Http Status Code:200)
{
"code":"SUCCESS",
"message":"请求处理成功",
"data":{
"taskId": "xxxx"
"status": "任务当前状态",
"remark": "拷贝状态说明",
"progress": "进度%",
}
}
1.4. 错误返回:
状态码 | code | message | data | 原因 |
---|---|---|---|---|
200 | NO_AVALIBLE_DATASOURCE | 没有可用数据库连接 | NULL | 没有可用数据库连接配置 |
200 | OBJECT_REQUIREDFIELD_EMPTY | {XXX}属性必填 | NULL | 连接属性缺少type/ip/port/username/password/database |
200 | FILE_FORMAT_ERROR | 配置文件格式不正确,请下载并参考数据导入配置模板文件 | NULL | 文件类型错误 |
200 | IMPORT_CONFIG_ERROR | {bosclass}配置错误,{error} | NULL | 配置错误 |
200 | UNKNOWN_DATABASE | 目标数据库{database}不存在 | NULL | database数据库不存在 |
200 | ACCESS_DENIED | 第三方数据库连接失败,账号或密码错误 | NULL | 账号或密码错误 |
200 | NOT_SUPPORT_RELATION_MODE | MySQL不支持FULL JOIN连接方式 | NULL | MySQL数据库不支持FULL JOIN关联方式,当type为MySQL,且使用fullJoin时 |
200 | IMPORT_CONFIG_ERROR | {xxx}配置错误,数据库表{yyy}不存在 | NULL | 导入数据库表不存在 |
200 | IMPORT_CONFIG_ERROR | {xxx}配置错误,列{yyy}不存在 | NULL | 导入结构化数据库的表字段不存在 |
1.5. 注意事项:
- 使用对应的数据源配置进行连接测试
- 支持以下数据库,左侧为连接名:
MySQL: MySQL(TCP/IP)
PgSQL: PgSQL
Oracle: Oracle
SQLServer: Microsoft SQL Server(TPC/IP)
MongoDB: MongoDB - 先对配置进行校验,如配置不通过,返回错误,不进行导入。配置文件格式见附录七。
- 校验源数据表是否存在,对应字段是否存在。
- 校验目标类在BOS中是否定义,属性与对应字段类型是否一致。
- 如校验通过,生成导入任务记录到数据库task表,返回任务编码taskId。
- 状态码:
0:即将导入
1:正在导入
2:导入完成
-1:导入失败。 - 导入过程中出现错误记录到数据库,继续导入下一个表。
- 导入完成,记录导入数据统计到数据库。