# databaseMigrateImport

> 本接口应在服务器端调用，详细说明参见[服务端API](/miniprogram/dev/server/getting_started/api_signature.md)。

数据库导入

### 请求地址
```
POST https://api.weixin.qq.com/tcb/databasemigrateimport?access_token=ACCESS_TOKEN
```

### 请求参数

| 属性 | 类型 | 默认值 | 必填 | 说明 |
| ---- | ---- | ------ | -------- | ---- |
| access_token / cloudbase_access_token | string |  | 是 | [接口调用凭证](/minigame/dev/wxcloud/reference-http-api/functions/invokeCloudFunction) |
| env | string |  | 是 | 云环境ID |
| collection_name | string |  | 是 | 导入collection名 |
| file_path | string |  | 是 | 导入文件路径(导入文件需先上传到同环境的存储中，可使用开发者工具或 HTTP API的[上传文件](/minigame/dev/wxcloud/reference-http-api/storage/uploadFile) API上传） |
| file_type | number |  | 是 | 导入文件类型，文件格式参考[数据库导入指引](/minigame/dev/wxcloud/guide/database/import)中的*文件格式*部分 |
| stop_on_error | bool |  | 是 | 是否在遇到错误时停止导入 |
| conflict_mode | number |  | 是 | 冲突处理模式 |

**file_type 的合法值**

| 值 | 说明 | 最低版本 |
| -- | ---- | ---- |
| 1 | JSON |  |
| 2 | CSV |  |

**conflict_mode 的合法值**

| 值 | 说明 | 最低版本 |
| -- | ---- | ---- |
| 1 | INSERT |  |
| 2 | UPSERT |  |

### 返回值

### Object

返回的 JSON 数据包

| 属性 | 类型 | 说明 |
| ---- | ---- | ---- |
| errcode  | number | 错误码 |
| errmsg  | string | 错误信息 |
| job_id  | number | 导入任务ID，可使用[数据库迁移进度查询](databaseMigrateQueryInfo) API 查询导入进度及结果 |

**errcode 的合法值**

| 值 | 说明 | 最低版本 |
| -- | ---- | ---- |
| 0 | 请求成功 |  |
| -1 | 系统错误 |  |
| -1000 | 系统错误 |  |
| 40014 | AccessToken 不合法 |  |
| 40097 | 请求参数错误 |  |
| 40101 | 缺少必填参数 |  |
| 41001 | 缺少AccessToken |  |
| 42001 | AccessToken过期 |  |
| 43002 | HTTP METHOD 错误 |  |
| 44002 | POST BODY 为空 |  |
| 47001 | POST BODY 格式错误 |  |
| 85088 | 该APP未开通云开发 |  |
| 其他错误码 | [云开发错误码](/minigame/dev/wxcloud/reference/errcode) |  |

### 请求数据示例

```json
{
	"env": "qbasetest-a5c40e",
	"collection_name": "test1",
	"file_path":"test_import",
	"file_type":1,
	"stop_on_error": false,
	"conflict_mode": 2
}
```

### 返回数据示例

```json
{
    "errcode": 0,
    "errmsg": "ok",
    "job_id": 100074947
}
```
