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

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