Upload Action

Upload Action 目前主要服务于FE的前端页面,用于用户导入一些测试性质的小文件。

上传导入文件

用于将文件上传到FE节点,可在稍后用于导入该文件。目前仅支持上传最大100MB的文件。

Request

1. POST /api/<namespace>/<db>/<tbl>/upload

Path parameters

  • <namespace>

命名空间,目前仅支持 default_cluster - <db>

指定的数据库 - <tbl>

指定的表

Query parameters

  • column_separator

可选项,指定文件的分隔符。默认为 \t - preview

可选项,如果设置为 true,则返回结果中会显示最多10行根据 column_separator 切分好的数据行。

Request body

要上传的文件内容,Content-type 为 multipart/form-data

Response

1. {
2. "msg": "success",
3. "code": 0,
4. "data": {
5. "id": 1,
6. "uuid": "b87824a4-f6fd-42c9-b9f1-c6d68c5964c2",
7. "originFileName": "data.txt",
8. "fileSize": 102400,
9. "absPath": "/path/to/file/data.txt"
10. "maxColNum" : 5
11. },
12. "count": 1
13. }

导入已上传的文件

Request

1. PUT /api/<namespace>/<db>/<tbl>/upload

Path parameters

  • <namespace>

命名空间,目前仅支持 default_cluster - <db>

指定的数据库 - <tbl>

指定的表

Query parameters

  • file_id

指定导入的文件id,文件id由上传导入文件的API返回。 - file_uuid

指定导入的文件uuid,文件uuid由上传导入文件的API返回。

Header 中的可选项同 Stream Load 请求中 header 的可选项。

Request body

要上传的文件内容,Content-type 为 multipart/form-data

Response

1. {
2. "msg": "success",
3. "code": 0,
4. "data": {
5. "TxnId": 7009,
6. "Label": "9dbdfb0a-120b-47a2-b078-4531498727cb",
7. "Status": "Success",
8. "Message": "OK",
9. "NumberTotalRows": 3,
10. "NumberLoadedRows": 3,
11. "NumberFilteredRows": 0,
12. "NumberUnselectedRows": 0,
13. "LoadBytes": 12,
14. "LoadTimeMs": 71,
15. "BeginTxnTimeMs": 0,
16. "StreamLoadPutTimeMs": 1,
17. "ReadDataTimeMs": 0,
18. "WriteDataTimeMs": 13,
19. "CommitAndPublishTimeMs": 53
20. },
21. "count": 1
22. }

Example

1. PUT /api/default_cluster/db1/tbl1/upload?file_id=1&file_uuid=b87824a4-f6fd-42c9-b9f1-c6d68c5964c2