调用CreateDBImportTask创建数据库导入任务。

创建导出任务成功后,将会返回任务ID、上传文件的地址和鉴权信息。您需要在要求的时间内向给定的地址上传需要导入的文件。上传文件成功之后,您需要调用QueryDBImportTaskStatus接口来触发运行导入任务,并查询数据导入状态。

上传文件时,请求方法请使用POST方法,Content-Type指定为multipart/form-data。下面是使用curl命令上传文件的一个示例。


curl -X POST \
-H 'Content-Type: multipart/form-data' \
-F 'key=${FileKey}' \
-F 'policy=${Policy}' \
-F 'OSSAccessKeyId=${AccessKeyId}' \
-F 'Signature=${Signature}' \
-F 'file=@${FilePath}' \
'${Host}'

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateDBImportTask

系统规定参数。取值:CreateDBImportTask。

Collection String test

集合名称。

FileType String CSV

导入文件类型,可选值为:

  • JSON
  • CSV
Mode String UPSERT

冲突处理模式,可选值为:

  • INSERT(默认) :导入出现冲突则忽略。
  • UPSERT:导入出现冲突则使用文件中的内容更新。
SpaceId String 0e16bb12-14af-4635-b24c-5ac1a9a*****

服务空间ID。

返回数据

名称 类型 示例值 描述
AccessKeyId String LTAIupaslTlU*****

上传文件使用的AccessKeyId。

ExpireTime String 2020-07-20T05:32:03Z

上传文件的过期时间。

FileKey String mongo/import/0e16bb12-14af-4635-b24c-5ac1a9*****/20200720130203_973820af-966d-42ec-9fab-17dfe4a******.csv

上传文件使用的FileKey。

Host String https://mps-zjk-share.oss-cn-zhangjiakou.aliyuncs.com

上传文件用使的Host。

Policy String eyJleHBpcmF0aW9uIjjoiMjAyMC0wNy0yMFQwNTozMjowMy40NDVaIiwiY29uZGl0aW9ucyI*****Y29udGVudC1sZW5ndoiMjAyMC==

上传文件使用的Policy。

RequestId String 692DCFEF-46DD-4EBB-B1DB-338E687DC260

唯一请求ID。

Signature String *****luWDvbmhqwwy9pm/Mso++pk=

上传文件使用的Signature。

TaskId String 973820af-966d-42ec-9fab-17dfe4a*****

任务ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateDBImportTask
&Collection=test
&FileType=CSV
&Mode=UPSERT
&SpaceId=0e16bb12-14af-4635-b24c-5ac1a9a*****
&<公共请求参数>

正常返回示例

XML 格式

<CreateDBImportTaskResponse>
      <Policy>eyJleHBpcmF0aW9uIjjoiMjAyMC0wNy0yMFQwNTozMjowMy40NDVaIiwiY29uZGl0aW9ucyI*****Y29udGVudC1sZW5ndoiMjAyMC==</Policy>
      <FileKey>mongo/import/0e16bb12-14af-4635-b24c-5ac1a9*****/20200720130203_973820af-966d-42ec-9fab-17dfe4a******.csv</FileKey>
      <TaskId>973820af-966d-42ec-9fab-17dfe4a*****</TaskId>
      <RequestId>692DCFEF-46DD-4EBB-B1DB-338E687DC260</RequestId>
      <AccessKeyId>LTAIupaslTlU*****</AccessKeyId>
      <Signature>*****luWDvbmhqwwy9pm/Mso++pk=</Signature>
      <Host>https://mps-zjk-share.oss-cn-zhangjiakou.aliyuncs.com</Host>
      <ExpireTime>2020-07-20T05:32:03Z</ExpireTime>
</CreateDBImportTaskResponse>

JSON 格式

{
	"Policy": "eyJleHBpcmF0aW9uIjjoiMjAyMC0wNy0yMFQwNTozMjowMy40NDVaIiwiY29uZGl0aW9ucyI*****Y29udGVudC1sZW5ndoiMjAyMC==",
	"FileKey": "mongo/import/0e16bb12-14af-4635-b24c-5ac1a9*****/20200720130203_973820af-966d-42ec-9fab-17dfe4a******.csv",
	"TaskId": "973820af-966d-42ec-9fab-17dfe4a*****",
	"RequestId": "692DCFEF-46DD-4EBB-B1DB-338E687DC260",
	"AccessKeyId": "LTAIupaslTlU*****",
	"Signature": "*****luWDvbmhqwwy9pm/Mso++pk=",
	"Host": "https://mps-zjk-share.oss-cn-zhangjiakou.aliyuncs.com",
	"ExpireTime": "2020-07-20T05:32:03Z"
}